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INTRODUCTION 


The TEKTRONIX 4114 Computer Display Terminal described in this section and discussed in detail in 
(Figure 1-1) is a high resolution graphics and alphanu- subsequent sections of this manual. 
merics terminal. The terminal’s features are briefly 


ABOUT THIS MANUAL 


This is the 4114 Computer Display Terminal Operator's RELATED DOCUMENTATION 
Manual. It explains in detail the features and capabili- 


ties of the terminal from the operator's point of view. Additiona! documentation is included in the following 
manuals: 

Before reading this manual, you should read “Introduc- @ 4114 Computer Display Terminal Host Program- 

ing Your 4114.” This short brochure provides initial tare Manual 


information and examples to help you use the 4114. 
@ 4110 Series Command Reference Manual 


@ 4114 Computer Display Terminal Service Manual 
Volumes 1 and 2 (Optional). 


SOFTWARE SUPPORT 
The new features of the 4114 don’t make your existing The 4114 can be driven by TEKTRONIX PLOT 10 
4010-series applications programs obsclete. software products: 


The 4114 is compatible with 4010-style graphics. In @ Interactive Graphics Library 


most cases, a program written and executed on a @ Terminal Control System (and associated packages) 


4010-family Tektronix terminal can be executed on 

your 4114 with few if any changes. The only modifica- 

tions necessary are those which take advantage of See the user’s manuals for those products for 

features that are new to the 4114. These include the information on how to generate graphics output. 

dialog area (see Section 2) and new features of 

graphics input (GIN) mode (see Section 4). If you choose to write your own software to drive the 
terminal, see the Host Programmer's Manual and the 


e Easy Graphing 


4110 Series Command Reference Manual for important 


information. 
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INTRODUCTION 


ABOUT THE 4114 


The rest of this section briefly introduces the 4114’s 
major features. References are made to sections in this 
manual where the features are discussed in detail. 


The major functional parts of the terminal are the 
display and the pedestal. 


SELF DIAGNOSTICS 


Every time you turn the terminal on, it tests certain 
parts of its circuitry. If there is a problem which would 
prevent use of the terminal or one of its options, a light 
pattern flashes on the indicator lamps on the keyboard. 
In some cases an error message is also displayed on 
the screen. 


You can record this light pattern and report it toa 
service technician. This makes it much easier and 
faster for the service person to correct the difficulty. 


See Appendix B and the discussion of the “Power 
Up Sequence” and “Self Test” in Section 2 for details. 


DIALOG 
AREA 


THE DISPLAY 


The display module (Figure 1-2) contains the circuitry 
for the terminal’s display and the screen itself. 


The Graphics Area 


Pictures (graphics) and text are displayed on the 19- 
inch screen. Graphics and text can be “stored” or 
displayed in “refresh.” 


Refresh Graphics. A refreshed vector is drawn repeat- 
edly on the screen, but is not stored. This allows the 
“visibility” of a vector to be turned on and off, and also 
makes it easier to move a graphics object around the 
screen. This feature is important for the use of 
“segments” and is discussed later in this section. 


lf your terminal has the color enhanced refresh feature 
(Option 31), the refreshed vectors are orange in color. 
If you do not have this option, the refreshed vectors are 
green, the same color as stored vectors. 


The brightness of refreshed vectors is controlled by the 
REFRESH INTENSITY control knob. 


REFRESH 
INTENSITY 


Figure 1-2. 4114 Display Module. 
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Segments 


A “graphics segment” is a picture or a part of a picture 
which can be manipulated by terminal commands. 


The 4114 stores segments locaiiy, allowing a graphics 
application program to be more flexible and allowing a 
greater interaction with the terminal operator. Local 
storage of segments also reduces terminal/host com- 
munications needs and allows the terminal to handle 
some of the computational and storage tasks for which 
the host would otherwise be responsible. 


Graphics Input 


Graphics input (GIN) mode allows you to send graphics 
information to a host resident program, either from the 
terminal, a plotter, or a graphics tablet. GIN mode 
functions in much the same way on a 4114 as it does 
on a 4010-family terminal, but with some added 
features. See Section 4 for details. 


Dialog Area 


The dialog area is a part of the terminal’s memory that 
stores non-graphics text which is the dialog between 
the terminal operator and the host or the terminal itself. 
The dialog may be invisible, entirely visible or a part of 
the dialog area may be visible. 


In most programs, text sent to and received from the 
host is dialog between the terminal operator and the 
application program or host monitor. You can define 
any portion of the screen as the area in which all such 
dialog appears. This keeps it from becoming mixed in 
with vectors and text which are intended as part of the 
graphics output. Dialog text is displayed in refresh, so it 
is not stored on the screen. 
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Setup Mode 


There are many English-like commands (called “setup 
commands”) which can be entered directly from the 
keyboard. These commands are used to prepare the 
terminal for communications with a host, describe and 
position the dialog area, specify what kinds of errors 
the terminal should report, contro! peripheral devices, 
and soon. 


You can enter setup commands when the terminal is in 
Setup mode. When the red light in the SET UP key is 
on, the terminai is in Setup mode. The setup commands 
are discussed in Section 6. 


The terminal “remembers” most setup commands after 
it is turned off and then turned back on. That means 
that you don’t need to enter the same setup commands 
every time you use the terminal! unless you want to 
change some of the setup parameters. 


There is also a set of commands called “escape 
sequences” which you can enter in Setup mode. 


Local Mode 


The LOCAL key initiates or terminates Local mode. 
When the terminal is in Local mode, it is as if it were 
not connected to a host computer. Data which would 
normally be sent to the host is interpreted as if it came 
from the host. Host input that comes to the terminal 
while it is in Local mode is stored in a queue and is 
executed when Local mode is terminated. If the dialog 
area is in use, text entered in Local mode appears in 
the diaiog area. 
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Error Reporting 


When the 4114 detects an error condition, it is 
recorded in an internal error queue and may be 
displayed on the screen. There are four levels of errors. 
You can establish the error threshold, which deter- 
mines whether or not an error message is displayed on 
the terminal (see ERRORLEVEL in Section 6). 


The terminal’s error messages are listed in Appendix A. 


THE PEDESTAL 
The display module rests on the pedestal (Figure 1-3). 
The pedestal contains the terminal’s internal logic, the 


keyboard, and the (optional) flexible disk drives. 


The Keyboard 

The 4114's keyboard (Figure 1-3) is described in detail 
in Section 2. Its featues include: 

e@ A typewriter-like keyboard for typed input 


@ Pre-programmed command keys for commonly used 
features 


® Programmable keys 


® indicator lights to inform you when the terminal is in 
a particular mode, or transmitting or receiving data 


@ Thumbwheels to scroll the dialog area and control 
the graphics input data 


OPTIONAL COMMUNICATIONS 


Option 01 provides block mode and duplex 
communications. Section 5 provides a brief overview of 
communications concepts. Section 6 includes explana- 
tions of commands which control communications. 


The Host Programmer’s Manual and the 4110 Series Com- 


mand Reference Manual have more detailed communi- 
cations information. 


PERIPHERALS 


The 4114 is compatible with most other Tektronix 
peripheral devices, such as plotters, printers, and 
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4114 OPERATOR'S 


INTRODUCTION 


INDICATOR LIGHTS 
_ FUNCTION KEYS 
COMMAND KEYS 
COMMAND KEYS 
THUMBWHEELS 
| TYPEWRITER-LIK | 
KEYS 
3673-3 


Figure 1-3. The 4114 Pedestal. 
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Section 2 


CONTROLS, INDICATORS, AND KEYBOARD 


This section is divided into two sub-sections. The first The second sub-section is a description of the terminal's 
explains the terminal’s controls and indicators. keyboard. 


CONTROLS AND INDICATORS 


disk drive indicator lamp(s) (optional) 


The terminal’s controls and indicators (Figure 2-1) ® 
melederthe:follewing: e REFRESH INTENSITY knob 
® power switch @ KBD LOCK lamp 
@ MASTER RESET button ® PAGE FULL lamp 
® SELF TEST bution © XMT lamp 
@ WRITE PROTECT switch(es) (optional) © RCV iamp 
e 


@ WRITE PROTECT indicator(s) (optional) thumbwheale 


SELF TEST MASTER RESET 


Figure 2-1. Terminal Controls and Indicators. 
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TURNING THE TERMINAL ON The Power up Sequence 
To turn the terminal on, push the power switch (Figure Each time you turn the terminal on, it automatically 
2-2). Release it when it clicks. A green indicator tests parts of its memory and circuitry. This is called 
appears in the switch. If you have a flexible disk drive the “power up sequence.” It takes from 15-60 seconds 
option in your terminal, you should also hear the depending on what options your terminal has, and 
ventilation fan inside the terminal turn on. requires no operator interaction. 
During the power up sequence the lights in the 
keyboard (Figure 2-4) go through the following se- 
quence: 


Do not block the air vents in the terminal's 
pedestal (Figure 2-3). If you do, the terminal could 
overheat and damage its circuitry. These air vents 
allow proper veniilation. 


@ All lights turn on. 

The CAPS LOCK light turns off. 

All other lights turn off. 

The XMT and RCV lights fiash once simultaneously. 
All tights turn off. 


POWER 
SWITCH 


Figure 2-2. The Power Switch. 
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Figure 2-3. The Air Vents. 
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If the terminal bell does not ring during the power up 
sequence (within 60 seconds of turning the terminal 
on), press the PAGE key (Figure 2-4). The screen is 
erased and the cursor flashes in the upper left corner 
of the screen. If the dialog area is enabled (see 
“DIALOG” later in this section) the cursor appears on 
the first available line of the dialog area. As soon as the 
cursor appears on the screen, the terminal is ready for 
use. 


If the power up sequence detects an error the terminal 
bell rings one, three, or four times, depending on the 
severity of the problem. There may also be a message 
on the screen. If this occurs, see Appendix B. 


POWER UP 


INDICATOR LIGHTS 


Figure 2-4. Keyboard Indicators In Power Up Sequence. 
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Power Up Defaults 


Much of the terminal's operating environment when it is 
turned on (power up defaults) depends on its environ- 
ment when it is turned off. 


Many elements of the operating environment can be 
altered under program control or by “setup com- 
mands.” The results of many of these changes are 
stored in “setup memory” and are remembered the 
next time the terminal is turned on. Table 6-1 (in 
Section 6) indicates the parameters which are saved in 
setup memory. 


Setup commands and Setup mode are discussed in 


this section under the heading “SET UP” and in 
Section 6. 


Table 6-1 also indicates the “factory default” operating 
environment of the terminal. “Factory default” means 
the setting which the terminal has when it is shipped 
from the factory. The status of your terminal is different 
from what is shown in that table if the parameters were 
altered by setup commands. See the STATUS 
command in Section 6 for information on how to 
determine the environment of your terminal. 


lf the setup memory fails, the operating environment is 
reset to the factory default. If this has happened, you 
are informed by a message during the power up 
sequence (see Appendix B). 


At times you may want to reset the terminal to all of its 
default parameters yourself. For this procedure, see 
Appendix B. 
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NOTE 


Do not press the MASTER RESET button if there 
is important information stored in the terminal's 
memory. Resetting the terminal deletes all graph- 
ics data as well as macros which have been 
programmed into keys. 


Use the MASTER RESET button (Figure 2-5) when you 
want to return the terminal to its power up condition. 


Pressing the MASTER RESET button has the same 
effect on the circuitry as if the terminal were turned off 
and back on: 


@ Macros are deleted from programmed keys. 
@ Graphics data is deleted from the terminal’s memory. 


@ The terminal runs its power up sequence. 


You can save information before resetting the terminal 
by making a hardcopy of the screen (the HARD COPY 
key is explained later in this section). If your terminal 
has the flexible disk(s) (Options 42 and 43) you can 
copy data to a disk or to a host file (see Section 3). 


When you press the MASTER RESET button in con- 
junction with the SELF TEST button, an extensive self 
testing procedure is initiated. 
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SELF TEST The SELF TEST can also be used to reset all terminal 
parameters to their factory default values. See Appen- 
The power up sequence is an abbreviated test of the dix B for details. 


terminal's memory and circuitry. 


A more extensive test of the terminal's operating 
conditions is initiated by the SELF TEST button (Figure 
9-5). The SELF TEST thoroughly tests the terminal and 
allows a service technician to make any necessary 
adjustments. Self test is more fully explained in 
Appendix B. 


SELF we 


TEST 


MASTER 
RESET 


Figure 2-5. The MASTER RESET and SELF TEST Buttons. 
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WRITE PROTECT SWITCH AND 
INDICATORS 


Your terminal may have one or two flexible disk drives 
(Options 42 and 43). If it does, they are located 
between the display and keyboard. There is a WRITE 
PROTECT switch for each disk drive. They are located 


in the panel located between the disk drives (Figure 2-6). 


If there is no disk in the drive, the red indicator light is 
always on. It cannot be turned off. 


When there is a disk in the drive and you press the 
WRITE PROTECT switch up, the light above the switch 
turns on. This means that the disk in the drive is “write 
protected.’ When a disk is write protected, the terminal 
will not write data on it. This prevents you from writing 
over (and thus destroying) data already on a disk. 


WRITE 
PROTECT 
INDICATORS 


DISK 
DRIVE 
INDICATOR 


Press the switch down to terminate the write protection 
feature (and turn off the light). You can also protect a 
disk by the PROTECT setup command (see Section 6) 
or by covering the ‘write protect” notch in the disk 
itself (see Section 3). 


For additional details on the use of the WRITE PRO- 
TECT switch and information on use of the disk drive, 
see Section 3. 


DISK DRIVE INDICATOR LAMP 


When the red light in the disk drive (Figure 2-6) is on, 
the drive is either reading from or writing to the disk. 
When the light is off, the drive is not operating. The use 


of the disk drives is explained in Section 3. 


DISK DRIVE 
INDICATOR 


WRITE 
PROTECT 
SWITCHES 


Figure 2-6. The WRITE PROTECT Switch, Indicator and Disk Drive Indicator. 
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CAUTION 


Do not open the disk drive’s door when the drive 
is operating (the red light is on). To do so 
interrupts the READ or WRITE in progress. Wait 
until the READ or WRITE is finished, then remove 
the disk. 


REFRESH INTENSITY 


The terminal's display is a “direct view storage tube” 
(DVST). The word “storage” means that vectors are 
drawn once on the display and stored there until they 
are erased, implying that the vectors cannot be moved. 
To modify a stored picture, you must erase the screen 
and redraw all the vectors and text. 


Besides displaying vectors which are stored on the 
display, the terminal can also display vectors in 
“rafresh.” A refreshed vector is not stored. it is redrawn 
at a fast enough rate that it appears to be stored. This 
allows the vectors to be moved around the screen 
dynamically, instead of having io be erased and 
redrawn. 


CONTROLS/INDICATORS/KEYBOARD 


The brightness of the refreshed vectors is controlled by 
the REFRESH INTENSITY knob (Figure 2-7). Turn the 
knob to the jeft to dim refreshed vectors; If you turn the 
knob too far, the refreshed vectors become invisible. 
Turn the knob clockwise to make the vectors more 
bright. If you turn the knob too far to the right, refreshed 
vectors become stored vectors. 


The amount of graphics that can be stored on the 
screen is virtually unlimited, but there is a limit to the 
amount of graphics that can be refreshed. When you 
reach that limit, the refreshed vectors begin to flicker. 
The graphics drawn in refresh are usually under 
program control, so as an operator you will not be able 
to affect it. 


Since the “dialog area” (expiained iater in this section) 

is in refresh you can reduce the flicker by: 

@ reducing the number of visible lines in the dialog 
area (see the DALINES command in Section 6). 


@ pressing the DIALOG key to make the dialog area 
not visible. 


® pressing the SHIFT and DIALOG/CLEAR keys at the 
same time to erase the entire contents of the dialog 
area. 


REFRESH 
INTENSITY 


Figure 2-7. The REFRESH INTENSITY Knob. 
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KBD LOCK 


When the KBD LOCK light (Figure 2-8) is on, the 
keyboard is “locked.” A program can lock the keyboard 
to prevent you from typing anything at a time which 
would interfere with data being sent from the host. 


When the keyboard is locked, you can still press the 
keys, but data is not transmitted, echoed, or queued. 
When you press any key (except BREAK or CAN- 
CEL) the terminal's bell rings to remind you that no 
data is being input. 


The program should unlock the keyboard when the 
transmission of the critical data is complete. 


You can also unlock the keyboard by pressing the 
MASTER RESET button or the CANCEL or BREAK 
keys. However, you should use MASTER RESET, 
CANCEL, and BREAK with caution. The MASTER 
RESET button deletes information in the terminal's 
memory. The CANCEL key terminates several terminal 
functions besides the locked keyboard. And the BREAK 
key may have undesirable effects on some host 
computers. 


For further details, see the explanations of MASTER 
RESET, BREAK, and and CANCEL in this section and 
the LOCKKEYBOARD command in Section 6. 


PAGE FULL 


When the PAGE FULL light (Figure 2-8) is on, the 
terminal will not display any more text or graphics until 
the “page full” condition is cleared. The “page full” is 
cleared when you press any key except the SHIFT. 


The MARGIN setup command (see Section 6) defines 
the number of columns into which the screen is divided 
for the display of text. When the cursor reaches the end 
of the last line of the last column, a page full condition 
exists. 


The terminal can be set up to make a hard copy of the 
Screen, erase the screen, and continue automatically. 
See the PAGEFULL setup command in Section 6 for 
details. 


XMT 


The abbreviation “XMT” stands for “transmit.” The 
transmit light (Figure 2-8) is on when data is being sent 
from the terminal to the host computer. 
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RCV 


The abbreviation “RCV” stands for “receive.” The 
receive light (Figure 2-8) is on when data is being 
received by the terminal from the host computer. 


THE THUMBWHEELS 


The thumbwheels (Figure 2-9) have two uses: 
@ to scroll the dialog area. 


® to locate a point on the screen to be sent toa 
graphics program being run from a host computer, 


The dialog area is discussed later in this saction under 
the heading “DIALOG.” Using the thumbwheels when 
the terminal is in graphics input (GIN) mode js 
discussed in Section 4. 


Figure 2-8. The KBD LOCK, PAGE FULL, XMT and RCV 
Indicator Lights. 


sea snmnanaovnnrecasttencetittietbenannretuldicrnton eenineoniennintsctate, 


Figure 2-9. The Thumbwheels. 
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THE KEYBOARD 
The keyboard can be grouped into five categories: The “space” is a printing character. 
© Alphanumeric Keys If you hold down an alphanumeric key for more than 
@ Control Keys half a second, the character repeats at a rate of 10 


@ The BREAK Key le La haa until you release the key or press 


@ Command Keys 
When the terminal! is in Local! or Setup mode and you 


@ Function Keys press an alphanumeric key, it is displayed (echoed) on 
the screen. Whether or not the characters are echoed 
ALPHANUMERIC KEYS when you are logged onto a host computer depends on 
whether the terminal or the host is providing the echo. 
NOTE See the ECHO command in Section 6 for details. 
Four optional keyboards are available for interna- The character normally transmitted by an alphanumer- 
tional use (see Appendix E). Descriptions in this ic key can be replaced by a “macro” (a character or 
section apply to the standard keyboard. There are character string programmed into the key). This is 
variations if your terminal has an optional key- explained later in this section under the heading 
board. “Function Keys.” 


Most of the keyboard looks like a typewriter (Figure 2-10). 
The alphanumeric keys transmit the characters 

shown on their keycaps to the terminal or to a host 
computer. These are also called “printing” characters 
since they have symbolic representations which are 
“printed” (echoed) on the screen or printed by a line 
printer. 


Figure 2-10. Aiphanumeric Keys. 
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CONTROL KEYS 


The terminal can send and receive all standard control 
characters. A “control character” is a character that 
has a special meaning for the terminal or host 
computer. When some control characters are transmit- 
ted, you may not see them echoed or see their result on 
the display. 


Several control characters have a specific meaning to 
the terminal. For example, the “carriage return” control 
character causes the cursor to return to the left 
margin; the “line feed” control character causes the 
cursor to move down one line. 


There are six control characters which have their own 
keys (Figure 2-11): 

@ RUB OUT (delete) 

BK SPC (back space) 

LINE FEED (line feed) 

RETURN (carriage return) 

ESC (escape) 

TAB (horizontal tab) 


The CTRL and SHIFT keys are included in the following 
description of the control keys because they are used 
to specify control characters which are not represent- 
ed on the keyboard. 


RUBOUT 


The RUB OUT key sends the “rub out” (or delete”) 
character. 


The RUB OUT is the factory default “character delete” 
key in Setup mode. See the explanation of the ED- 
ITCHARS command in Section 6. 


BKSPC 


The BK SPC key sends the “back space” character, 
which moves the cursor one character position to the 
left. 


If the cursor is in the dialog area and it is already at the 
left margin when you press the BK SPC key, the cursor 
does not move. If the cursor is not in the dialog area 
and it is already at the left margin when you press the 
BK SPC key, the cursor moves to the right margin of 
the same line. 


LINE FEED 


RETURN 


Figure 2-11. The Control Keys. 
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LINEFEED 


This key sends the “line feed” character, which causes 
the cursor to move down to the next line without 
returning it to the left margin. 


If the cursor is at the bottom of the screen and is not in 
the dialog area, a line feed moves it to the top of the 
screen one margin to the right of the current margin. 
When the cursor is at the bottom of the last column, a 
line feed either causes it to move to the top of the first 
column or causes a “page full” condition (see MARGIN 
and PAGEFULL in Section 6). 


You can use the setup command LFCR to cause a line 
feed received from the host computer (or from the 
terminal when it is in Local mode) to cause the terminal 
to generate a carriage return (see Section 6). 


RETURN 


The RETURN key sends the “carriage return” control 
character, which returns the cursor to the left margin of 
the current line. 


Some host computers automatically include a “line 
feed” when they echo or send the “return” character, 
so that pressing the RETURN key moves the cursor 
down one line and to the left margin. If your host does 
not, you can use the setup command CRLF (explained 
in Section 6) to cause the terminal to include a line 
feed with the return character. 


When in Setup mode, the terminal automatically 
errs 1 
Luni 


provides a Caiviage return-line feed when you press the 


FR yr pt 
RETURN key. 
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ESC 


The terminai sends the escape character when itis 
communicating with a host computer and you press 
this key. 


The “escape” is the first character in a special 
sequence called the “escape sequence.” These are 
commands issued to the terminal in a special format in 
Local and Setup modes. See Appendix C for details. 


For detailed explanations of all escape sequence 


ence Manual. 


TAB 
The TAB key transmits the horizonal tab character. 


Depending on how your host defines a tab, this 
character can cause the cursor to move a number of 
spaces to the right. 


When the terminal is in Local mode, the cursor moves 
one character to the right each time you press the TAB 
key. 


CTRL 


Some control characters are used often and have their 
own keys, such as RETURN and LINE FEED. 


However, you can also transmit these characters and 
all other contro! characters by holding down the CTRL 
key while you press another key. 


For example, press the CTRL key and the “G” key 
(CTRL-G) at the same time to send the “bell” character 
and cause the terminal bell to sound; CTRL-M sends a 
“carriage return” character and causes the cursor to 
return to the left margin; CTRL-J sends the “line feed” 
character and causes the cursor to go down one line. 
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SHIFT 


Most keys have two meanings: “unSHIFTed” and 
“SHIFTed.” 


When you press the key labeled “W” while holding the 
SHIFT key, the terminal sends the upper case charac- 
ter (W); pressing the same key without the SHIFT (if the 
CAPS LOCK key light is not on) sends the lower case 
letter (w). Some keys are labeled with two non- 
alphabetic characters, one above the other. For exam- 
ple, press the key labeled “5” to transmit a 5; press the 
same key and the SHIFT key to send the percent (%) 
character. 


Programmable function keys can also have shifted and 
unshifted meanings, as explained elsewhere in this 
section under the heading “Function Keys.” The 
command keys, (see “Command Keys” elsewhere in 
this section) have shifted and unshifted functions 
programmed into them as labeled on the keyboard. 


The SHIFT key is also used at the same time as the 
CTRL key to send some control characters. 


THE BREAK KEY 


The BREAK key (Figure 2-12) can be used to “inter- 
rupt” communications from some host computers to 
the terminal. It is in a category by itself because it does 
not actually send a character to the host. It alters the 
state of the communications line such that the compu- 
ter stops the sending of information to the terminal or 
stops the execution of a program. 


The length of time that the interrupt lasts is important 
to some host computers. You can use the setup 
command BREAKTIME to specify the length of the 
interrupt sent by the terminal to the host, or to disable 
the BREAK key, as explained in Section 6. 


It is also important that various host computers react 
differently when they receive the BREAK. One host 
might stop the execution of a program while another 
may log you off the host and break the communications 
link to the computer. Therefore, before using the 
BREAK key or BREAKTIME commana, you should find 
out how the interrupt is handled by your host. 


Pressing the BREAK key also unlocks the keyboard 
(see “KBD LOCK” earlier in this section.) 


Figure 2-12. The BREAK Key. 
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COMMAND KEYS 


There are six command keys (Figure 2-13) which 
perform special functions or put the terminal into a 
particular mode of operation. These keys cannot be 
programmed to do any other function. Their purpose is 
to allow you to easily access frequently used terminal 
features. 
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The functions performed by the command keys are 
discussed in the following order: 


PAGE 

CAPS LOCK 
SET UP 
DIALOG 
CLEAR 
LOCAL 
CANCEL 
COPY 


[i st ee 


Figure 2-13. The Command Keys. 
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PAGE 


When you press the PAGE key, the following items are 
erased: 


® graphics that are not part of a graphics segment (a 
“graphics segment” is a picture or part of a picture 
which can be manipulated by 4114 commands). 


® text that is not part of a graphics segment and not in 
the dialog area. 


The following are erased momentarily and then re- 
drawn when you press the PAGE key: 


@ the dialog area. 
® graphics inciuded in a segment. 
@ text included in a segment. 


A segment is permanently erased by being deleted 
from the terminal’s memory. A segment can also be 
made “invisible” (not erased from the terminal's 
memory, but not visible either). After a segment has 
been deleted or made invisible, you still need to press 
the PAGE key to erase its image from the screen. 


If the dialog area is not enabled (see “DIALOG” 
elsewhere in this section) the following actions occur 
when you press the PAGE key. Because of these 
actions, it is generally best not to press PAGE while a 
program is running and the dialog area is not enabled. 
(These actions do not take place if the dialog area is 
enabled.) 


@ the cursor returns to the home” position (the upper 
left corner of the screen). 


®@ the terminal goes into alpha mode (that is, it 
interprets all incoming data as alphanumeric data, 
not graphic data). 


@ the linestyle is set to solid. 


@ 4010-style graphics input (GIN) mode is terminated. 
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CAPS LOCK 


The CAPS LOCK key is similar to the “Shift Lock” key 
on a typewriter. 


When you press CAPS LOCK, the red light in the key 
comes on and alphabetic characters are transmitted in 
upper case. The CAPS LOCK does not cause the upper 
case version of numeric, command, or function keys to 
be transmitted. 


The CAPS LOCK allows you to easily send only 
uppercase alphabetic characters to the host, but still 
allows you to conveniently send numeric characters 
rather than special symbois. This is especially useful 
on host systems which do not accept lowercase 
alphabetic characters. 


SET UP 


When you press the SET UP key, the light in the key 
turns on and the terminal enters Setup mode. (If the 
dialog area is enabled, the light in the DIALOG key also 
turns on. See the discussion of the dialog area later in 
this section.) With the terminal in Setup mode you can 
type English-like commands (called “setup” com- 
mands) directly to the terminal. 


Setup commands allow you to establish the terminal’s 
operating environment and to use peripherals attached 
to the terminal. For example, setup commands are used 
for such things as establishing communicatons rates, 
inquiring about the terminal's status, determining what 
kinds of errors the terminal should display, and pro- 
gramming special meanings (macros) into keys. 


The results of many setup commands are stored in 
setup memory. Specifications stored in the setup 
memory are remembered even if the terminal is turned 
off, unplugged, plugged in, and turned on again. 


See Section 6 for a description of Setup mode and all 
of the setup commands. 
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DIALOG 


Part of the screen can be used to display your 
“conversation” (dialog) with the terminal and the host 
computer. This portion of the screen is called the 
“dialog area.” 


The text which can be written in the dialog area 
includes: 

® the terminal’s error messages. 

@ commands entered in Setup mode. 


@ text entered in Local mode (most commands entered 
in Local mode are not echoed on the screen). 


® non graphics (alpha) text included in a graphics 
program. 


@ host generated messages, such as: 
prompts 
warnings 
error messages 


@ normal terminal/host communications. 


The dialog area is displayed in refresh. Its brightness is 
controlled by the REFRESH INTENSITY knob. 


See the explanation of the CLEAR key later in this © 
section for details on how to erase text from the dialog 
area. 


DAENABLE 


(ei@ronwx 4714) 


ALPHA TEXT 
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Enabling the Dialog Area. Text is directed to the 
dialog area when the dialog area is enabled. When the 
dialog area is disabled, text is dispiayed with graphics. 
The DAENABLE command is used to enable or disable 
the dialog area. As illustrated in Figure 2-14, if the 
dialog area is enabied, the text is directed to the dialog 
buffer. The dialog buffer can be thought of as a scroll, 
part of which is displayed at a time, at a specified 
screen location. - 


Whether or not the dialog area is enabied is stored in 
setup memory. For example, if you enable the dialog 
area and turn the terminal off, it will be enabled the 
next time you turn the terminal on. 


4010-Compatibility. if a program is written to be run 
on the 4114, the terminal can distinguish between text 
which is part of the graphics (‘graphics text” such as 
titles and labels) from text which is not part of graphics 
(non-graphics, or “alpha” text). Graphics text is dis- 
played with the graphics. Alpha text is sent to the 
dialog area. Programs written for 4010 and 4020 
Tektronix terminals can also be run on the 4114, but 
special consideration must be made for text since 
those terminals do not have a dialog area. 


ij WINDOW DIALOG 
(DALINES) > BUFFER 
(DABUFFER) 


Figure 2-14. Enabling the Dialog Area. 
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For example, you can run a program on the 4114 which 
was originally written for a 4010 terminal. If the 
program includes text (such as a title or labels) and the 
dialog area is active, the 4114 would strip the title and 
labels out of the picture and display that text in the 
dialog area. 


This is the reason for the DAENABLE command. When 
the dialog area is “disabled,” the 4114 does not 
intercept text and display it in the dialog area, allowing 
a 4010-style program with text to execute on a 4114 
just as on a 4010-family terminal. 


Dialog Area Visiblility. Even if the dialog area is 
enabled, it must also be made visible so you can see 
the text which is sent to it. If the dialog area is enabled 
but not visible, dialog is written in the dialog area but 
neither the text nor the cursor is visible. 


The DIALOG key is used to make the dialog area 
visible or not visible. When the red light in the key is on, 
the dialog area is visible. When the red light in the key 
is off, the dialog area is not visible. (You can also use a 
setup command called DAVIS to make the dialog area 
visible or not visible, see Section 6.) 


If the dialog area is enabled when you turn on the 
terminal, the light in the DIALOG key turns on, the 
dialog area is visible, and the cursor is displayed in the 
dialog area. If the dialog area is not enabled when you 
turn on the terminal, the dialog area is not visible and 
the cursor appears in the upper left corner of the 
screen. 


Dialog Area Buffer. You can specify the total size of 

the dialog buffer with the DABUFFER command. This 

command allocates a certain amount of the terminal's 
memory for a buffer in which the dialog is stored. The 
factory default is 15 lines. 


When the dialog buffer is full, the first line is deleted so 
another line of dialog can be added to the end. 


The maximum length of each line is specified by the 
DACHARS command. 


Visibie Portion of the Dialog Area. It is not usually 
necessary or desirable to have the entire dialog buffer 
visible. The DALINES setup command specifies the 
number of visible lines in the aoe buffer. The factory 
default is five lines. 


The dialog area is stored in refresh. Its brightness is 
controlled by the REFRESH INTENSITY knob. 


When the dialog area is visible you can use the top 
thumbwheel (Figure 2-9) to move (scroll) through the 
dialog area to observe its entire contents. As you 
“scroll,” you are moving the “window” shown in Figure 
2-14, so different lines in the dialog area are visible. 
The cursor stays on the line below the last line of 
dialog. This assures that information sent to the dialog 
area while you ‘are examining it does not overwrite 
information already in the dialog area. 


Line Length. The maximum length of each line in the 
dialog area is specified by the DACHARS setup 
command. The factory default is 73. 


Dialog Area Writing Mode. The DAMODE setup com- 
mand specifies whether a character in the dialog area 
is overwritten or replaced when you backspace over it. 
The factory default condition is “replace.” That means 
that when the dialog area is enabled and visible and 
you backspace over a character, it is erased. The other 
setting is “overwrite.” That means that when the dialog 
area is enabled and visible and you backspace over a 
character, the terminal writes over the character with- 
out erasing it. 


A special “character delete” key is used to backspace 
in Setup mode. See the EDITCHARS command in 
Section 6. 
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Dialog Area Position. You can position the dialog area 
anywhere on the screen. The DAPOSITION command 
specifies the location of the lower left corner of the 
dialog area. The terminal positions the last visible line 
of the dialog area as close as possible to that location. 


For example, the factory default position is the lower 
left corner of the screen (0,0). This means that the 
dialog area is located such that the last visible line (the 
fifth line, by factory default) begins at the lower left 
corner of the screen. 


If you alter the configuration of the dialog area and 
move it, the location may not be exactly the one you 
specify. This is because the number of visible lines and 
fength of each line may not permit the dialog area to be 
displayed at the location you specified. 


CLEAR 


To erase the dialog area, press the SHIFT and 
DIALOG/CLEAR keys at the same time. This clears all 
text from the dialog buffer. The result is that the dialog 
area is erased. It does not erase any graphics on the 
screen or affect whether or not the dialog area is 
visible. 


OUTPUT 


\ 
LOCAL \ 
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LOCAL 


When you press LOCAL, the red light in the key turns 
on and the terminal enters Local mode. If the terminal 
is already in Local mode, pressing the key turns the 
light off and terminates Local mode. 


When in Local mode, communications to and from the 
host computer are temporarily suspended. Everything 
typed at the keyboard is interpreted by the terminal as 
if it came from the host. information or data received 
from the computer is not processed; it is put into a 
queue and processed when you exit from Locai mode. 


Figure 2-15 illustrates the flow of communications. 
Notice that when the terminal is in Local mode, data 
transmission is routed back to the terminal instead of 
being sent to the host. 


In Local mode you can enter commands (“escape 
sequences”) from the keyboard in the same format that 
a host uses and the terminal executes them as if they 
came from the host. 


If both Setup and Local modes are active, Setup takes 
priority. 


f 


HOST 
COMPUTER 


MODE } 


/ 
bB—$—$ @£@@ ———_——— 


Figure 2-15.Communications Flow in Local Mode. 


@ 
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CANCEL 


Press the SHIFT-LOCAL keys at the same time to 
initiate a CANCEL operation. The CANCEL: 


@ halts all disk, host, and 3PPI file copy operations 
(except spooling, see Section 6). 


® cancels “bypass” mode (see BYPASSCANCEL in 
Section 6). 


@ terminates graphics input (GIN) mode (see Section 
4). 


@ unlocks the keyboard (LOCKKEYBOARD in Section 
6). 


If a file transfer is cancelled (see COPY in Section 6) 
the file is closed. All information in that file operation 
up to the time of the CANCEL command is preserved. 


COPY 


lf you have a hard copy unit attached to the terminal, 
you can make hard copies of the display. You can copy 
both refreshed and stored vectors, or just stored 
vectors. 


A compatible hard copy unit must be attached to the 
terminal (see Section 3) and the terminal and hard 
copy unit must both be turned on. The hard copy unit 
may need to be on for a few minutes to warm up before 
it can make a good quality copy. 


To copy both refreshed and stored vectors, press the 
COPY key. The refresh vectors are stored, and a copy 
is made. After the copy is made, press the PAGE key. 
Refresh vectors which were stored are erased; they 
remain on the screen in refresh. 


To copy just the stored vectors, press the SHIFT and 
COPY keys at the same time. 


During the hard copy operation (which takes about ten 
seconds) a vertical line sweeps across the screen from 
right to left. Data being sent to the terminal during the 
hard copy operation is queued until the hard copy is 
finished. Data transfer operations and other non-dislay 
terminal functions continue while the hard copy is 
being made. 


FUNCTION KEYS 


Most of the terminal’s keys are programmable. This 
means that you can define the character or character 
string that is transmitted when you press a particular 
key. The character string or individual character as- 
signed to a key is called a “macro.” 


The eight programmable function keys (Figure 2-16) 
transmit nothing unless they are programmed. The 
alphanumeric and control keys have characters as- 
signed to them, but they can be assigned a macro 
instead. 


FUNCTION 
KEYS 


Figure 2-16. Programmable Function Keys. 
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Most keys can have two macros (shifted and unshift- 
ed). There is no shifted version of some keys, so they 
can have just one macro. A few keys are reserved for 
specific commands and cannot be programmed. Figure 
2-17 illustrates keys which are not programmable. 


The DEFINE setup command (see Section 6) is used to 
program a macro into a key. When you press a key that 
has a macro programmed into it, the key is “expanded” 
into the macro. 
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When the terminal is reset or turned off, macros are 
deleted from the terminal’s memory. The DEFINE 
command can also be used to delete macro or return a 
key to its original meaning. 


COMMAND 
KEYS 


Figure 2-17. Non-Programmable Keys. 
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Section 3 


HARDWARE OPTIONS AND PERIPHERALS 


This section explains the use of the disk drive and 
three port peripheral interface (SPP!) options to the 
4114. It also explains how to attach the optional 
graphics tablets to the terminal. Since the tablets are 
always used for graphics input, their use is explained 
in Section 4. 


This section also includes instructions on the use of 
the following TEKTRONIX peripheral devices with the 
terminal: 


® 4631 and 4611 hardcopiers 
@ 4662 and 4663 plotters 
® 4923 tape drive 


THE DISK DRIVE(S) 


Figure 3-1 shows a 4114 terminal with two flexible disk 


drives built into it (Option 43). Disk drive 0 is on the 


right and drive 4 is on the feft. If you have just one drive 


(Option 42) it is on the right and is labeled 0. 


The di 


Tt k drives are used for local storage of segments, 
macro 


, text fonts, and general text data. 


an on 


WRITE 
PROTECT 


Figure 3-1. The Flexible Disk Drives. 
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HOW TO INSERT A DISK 


Figure 3-2 illustrates the front and back sides of a 
flexible disk. 


To insert a flexible disk, open the door to the drive by 
lifting up on the door bar (Figure 3-1). Insert the disk 
notched edge first, with the label facing up (Figure 3-3). 
Slide the disk in enough that it stays, but not hard 
enough to bend the disk. Push down on the door to 
close it. 


Remove the disk when you are through using it by 
pushing up on the door bar. The door will open and 
your disk will pop out. 


Figure 3-3. Inserting a Flexible Disk. 


Figure 3-2. Flexible Disks. 
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Do not remove a disk while the light in the disk 
drive’s door is lit; it indicates that the disk is in 
operation. Removing an operating disk halis the 
operation in progress, and may damage or de- 
stroy your data. 


HANDLE THE DISKS WITH CARE 


Flexible disks are easy to store and handle. It is 
important to take a few simple precautions to insure 
the integrity of your data. 


Do not bend flexible disks intentionally since they 
crease and tear, which destroys the data stored on 
them. Oil, dirt, and dust on the disk cause problems 
when the disk head tries to read the disk, so touch onty 
the paper sleeve when handling the disk. Always keep 
the disks in jackets when not in use. Disks shouid be 
stored in a place protected from dust, extreme heat 
(above 122°F, 50°C) and extreme cold (below — 40°F, 
—40°C). 


If you are storing critical data on the disk, it is always 
safest to back up the data with a second copy. 


The disk should last for about 3,500,000 read/write 
operations per track or 30,000 insertions, whichever 
comes first. When the disk begins to wear out you will 
see translucent rings around its edges. You will also 
notice repeated errors when you try to read from or 
write to the disk. When this occurs, discard the disk 


and use the backup. 


SS VOSA 


WRITE PROTECTING A DISK 


There are three ways to protect a disk or files on the 
disk from being inadvertently deleted or overwritten by 
different data. 


The WRITE PROTECT switch (Figure 3-1) on the disk 
drive protects the entire disk. When the write protect 
feature is active, the red light in the switch is on and 
you cannot format, delete a file from or add a file toa 
disk in that drive. An error results whenever you 
attempt to do so. 
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You can also use the setup command PROTECT to 
protect an entire disk or individual files on the disk. 
Using the PROTECT command does not prevent you 
from reformatting a disk; it only prevents you from 
writing to or copying from a disk. See the explanation of 
the PROTECT command in Section 6. 


Some disks also have a “write protect” notch in them. If 
the disk you use has a write protect notch, you cannot 
write to the disk when that notch is exposed. Before 
writing to the disk, you must cover the notch with a 
piece of opaque tape. 


USING THE DISK DRIVE COMMANDS 


The following brief example illustrates the use of a disk 
drive. It includes the use of the FORMAT, SAVE, 
DIRECTORY, LOAD, PROTECT, and DELETE com- 
mands. This example also uses the DEFINE command 
to create three macros, which are then saved to a disk 
file. You may need to read the explanation of DEFINE in 
Section 6 prior to doing the example. 


All of the commands related to the disk drive are briefly 
presented in Table 3-1, following this example. 


Insert a disk in drive 0, following the directions under 
the heading “Inserting a Disk” earlier in this section. Be 
sure that the disk does not contain information that 
should be saved. 


Put the terminal in Setup mode. If the light in the SET 
UP key is not on, press the key. if it is already on, the 
terminal is already in Setup mode. 


Be sure the disk is not write protected. Toggle the 
WRITE PROTECT switch to its “down” position (the red 
light in the switch should be off). if the disk has a write 
protect notch, be sure it is covered with a piece of 
opaque tape. Enter the following setup command to 
assure that the disk has not been protected by the 
terminal: 


PROTECT FO: no “nr 
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Enter the following command to “format” the disk — 
prepare it for the creation of files: ‘ 


FORMAT FO:PRACTICE 368 x 


A disk must be formatted the first time it is used, to 
prepare the disk for storing files. Do not format a disk 
that has already been formatted unless you want to 
destroy all of the files on that disk and start over. 


While the disk is being formatted, the red light in the 
disk drive’s door comes on indicating that the disk 
drive is operating. It takes about 15 seconds to format 
the disk. Continue with the next step in the example 
when the red light goes out. (Do not open the disk 


The parameters indicate that the disk in drive 0 should 
be named “PRACTICE” and that the maximum number 
of files allowed on the disk is 368. 


Program macros into keys F1, F2, and F3 with the 
following DEFINE command. Remember that the “‘liter- 
al” character must precede the carriage return which is 
included in the macro. In this example the tilda (~) is 
the literal character. It is shown above the ©r because 
when you use it the cursor backspaces and the °r 
types over it. See the DEFINE and EDITCHARS 
commands in Section 6 for details. 


DEFINE F1 /STATUS ©r / CR 
DEFINE F2 /STATUS DIALOG ©r / Cr 
DEFINE F3 /STATUS BAUDRATE ¢r / Cr 


Press F1, F2, and F3 to be sure they are programmed. 
A general status report, the status of the dialog area 
and of the BAUDRATE command should be displayed. 
If a “page full” condition occurs, press any alphanu- 
meric key or PAGE to continue. 


Save the macros onto the disk with the following 
command: 

SAVE MAC ALL TO FO:KEYS Cr 

This command saves all of the macros currently 


defined. The file on the disk in drive O that the 
segments are saved to is named ‘keys.’ 


Display a directory of the disk with the following 
command to be sure that the file was created. A 
directory similar to the one in Figure 3-4 is displayed. 


DIRECTORY FO: Cr 


Press the terminal’s RESET button (located on the 
pedestal, below the right edge of the keyboard.) The 
terminal goes through the power up procedure, which 
takes about 15 seconds to one minute. Among other 
things, this deletes the macros currently programmed 
into the keys. 


Press function keys F1, F2, and F3. The terminal 
takes no action because the macros have been 
deleted. 


Press the SET UP key to put the terminal back into 
Setup mode. 


*DIRECTORY FO: 

—-NAME 

FQ: PRACTICE 
KEYS 


BLOCKS BYTES PROTECT 
2002 NO 
98 NO 


~ENTRIES USED: 
-ENTRIES FREE: 
-BLOCKS USED: 
-BLOCKS FREE: 
-LARGEST FREE: 
x 


Figure 3-4. A Disk Directory. 
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Load the macros into the terminal from the disk by 
entering the following command: 


LOAD FO:KEYS Cr 


The red light in the disk drive door turns on indicating 
that the disk is operating. When it finishes loading the 
specified file, the light in the door turns off. 


Press F1, F2, and F3. The macros which you saved 
have been programmed back into the function keys by 
the LOAD command. 


Deiete “KEYS” from the disk by entering the following 
command: 


DELETE FO:KEYS Cn 


Enter the DIRECTORY command to be sure that the 
file was deleted: 


DIRECTORY FO: Cr 


The directory should no longer include the file named 
“KEYS.” 


DISK DRIVE COMMANDS 


Table 3-1 briefly introduces all of the terminal’s setup 
commands relating to the operation of the disk drives. 
The abbreviation (SPP!) appears next to those com- 
mands which are also used by the three port peripheral 
interface, which is explained later in this section. See 
Section 6 for detailed explanations of all setup com- 
mands. 
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Table 3-1 
THE DISK DRIVE COMMANDS 

Command Explanation 

COPY (3PPI) Copies data from one device to 
another. 

DELETE Deletes a specified file from a disk. 

DIRECTORY Displays a directory of an entire disk 

| or individual files. 

FORMAT intializes a disk so data can be 
stored on it in files. 

LOAD Reads data from a disk and executes 
it as if the data were a command file. 

PLOT (3PP1) Reads information from the 
terminal’s screen and sends it toa 

| specified output device. 

PROTECT Write protects or unprotects files on 
a disk. 

RENAME Assigns a new name to a file ona 
disk. 

SAVE Creates a file on a disk containing a 
graphics segment or special text 
font. 

SPOOL (3PPI) Copies data from one device to 


another, while still allowing the termi- 
nal to proceed as usual. 


Halts the spooling operation. 


HARDWARE OPTIONS & PERIPHERALS 


THE THREE PORT PERIPHERAL INTERFACE 


Table 3-2 


THE THREE PORT PERIPHERAL 
INTERFACE COMMANDS 


The 3PPI, Option 10, allows the terminal to communi- 
cate with peripheral devices. With the 3PPI installed 
(Figure 3-5), the terminal supports most devices which 
communicate through an RS-232 interface. 


The TEKTRONIX 4662 and 4663 plotters are explicitly 
supported by the 3PPI. 


Table 3-2 briefly introduces the commands associated 
with the terminal’s 3PPI. 


USING THE 3PPI 


To use the 3PPI, plug the RS-232 cable from the device 
into one of the ports in the interface. You then use a 
4114 setup command to assign an appropriate device 
driver to that port. 


For example, you could connect a 4668 plotter to port O 
of the 3PPI. You would put the terminal into Setup 
mode and enter the following command: 


PASSIGN P0:4663/T Cr 


Command Explanation 


PASSIGN Assigns a device driver to a port. 

PBAUD Specifies the baud rate for a port. 

PBITS Specifies the stop bits and data bits 
for a port. 

PCOPY Establishes a two-way 
communication path between two de- 
vices. 

PEOF Specifies the end of file string for a 
port. 

PEOL Specifies the end of line string fora 
port. 

PFLAG Establishes the flagging convention 
used by a port. 

PORTSTATUS Displays a report on the specified 
port. 

PPARITY Establishes the parity convention 


used by a port. 


3PPI 
Interface 


Figure 3-5. The Three Port Peripheral Interface (3PPI). 
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This command assigns the terminal’s 4663 “device 
driver” to peripheral port 0. The device driver trans- 
lates terminal commands into 4663 commands when 
the terminal sends data to the plotter, and 4663 
commands into terminal commands when the plotter 
sends data to the terminal. See the PASSIGN command 
in Section 6 for more complete information. 


The 3PPi supports any device with an RS-232 connec- 
tor with its “general device driver.” The general device 
driver does not translate commands from one format to 
another. 


In addition to assigning a device driver to a port, you 
must also be sure that communications parameters are 
set correctly. It is important for correct data transmis- 
sion that the parameters assigned to the port agree 
with the parameters of the device attached to the port. 
The parameters and the setup commands used to set 
them are: 


@ baudrate (PBAUD) 
flagging (PFLAG) 

stop bits (PBITS) 

data bits (PBITS) 

parity (PPARITY) 

end of line string (PEOL) 
end of file string (PEOF) 


For full information on the above commands please see 
Section 6, the Command Reference section. 


ATTACHING THE 4662 AND 4663 
PLOTTERS 


Plug the male end of an RS-232 cable into a 3PPI port 
and the female end into the MODEM port on the back of 
the plotter. 


The plotter is often connected between the host port 
and the terminal. However, if you wish to use all the 
capabilities of the terminal, connect the plotter to the 
terminal's 3PPI port and let the terminal drive the 
plotter. 


When the terminai and plotter are connectea, you must 
make sure that the parameters are set properly. Use 
the 4662 and 4663 Plotter Operator Manuals for 
information on how to set the communications parame- 
ters. 
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ATTACHING THE 4923 OPTION 1 
TAPE DRIVE 


You can attach a TEKTORNIX 4923 Option 1 Tape 
Drive to a 4114 peripheral port, using the terminal's 
general device driver. 


Plug the RS-232 cable into the MODEM port on the 
4923 and into one of the peripheral ports on the 
terminal. If it is plugged into peripheral port 0, for 
example, you would use the following command: 


PASSIGN PO:PPORT Cr 


Use the PBAUD command to match the port’s baud rate 
to the tape drive’s, as indicated by the 4923's baud 
rate contro! knob on the back of the tape drive. 


Use the terminal's PFLAG command to set character 
flagging to DC1/DCS. All other communicatons param- 
eters should be set to match the conventions used in 
the files on the tape. 


When the terminal is receiving data from a non-file- 
structured device, such as the 4923, you can indicate 
the “end-of-file” by pressing the terminal’s CANCEL 
key after all data has been transferred. This erases the 
last received data which would otherwise be left inside 
the 3PPI system. 
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THE GRAPHICS TABLETS 


The two graphics tablets are Options 13 and 14 to the 
terminal. 


Option 13 is 11" x 11” and Option 14 is 30” x 40”. 
Except for their size, the two tablets are identical. In 
this manual they are both referred to as “the graphics 
tablets” or “the tablets” since operating instructions 
are the same for both. 


This manual assumes that the hardware for the tablet 
is installed and that it is ready for use. If that is not the 
case, a qualified technician should follow the installa- 
tion instructions included in the 4110 Series F13/14 
Graphics Tablet Instruction Manua!. 


Figure 3-6 shows the smaller graphics tablet. Both 
tablets include: 
@ the tablet (with cables connected to it) 


@ the input devices (one or more of the following): 
a stylus (standard) 
a one button cursor (optional) 
a four button cursor (optional) 


© a bar magnet for restoring the tablet's bias 
@ aprecision grid (optional) 
Table 3-3 lists the terminal’s setup commands which 


deal specifically with the operation of the tablet. See 
Section 6 for more details. 


Figure 3-6. The 4114 and (Option 13) Graphics Tablet. 


Table 3-3 
TABLET SETUP COMMANDS 


Command 


Explanation 


TBFILTER Specifies the time and distance 
filtering the tablet is to use for 


strokes in Graphics Input mode 


TBHEADERCHARS Specifies the header characters 
used by the tablet when it sends data 


to the host program. 


TBSTATUS Specifies how the tablet emulates 


the TEKTRONIX 4953 or 4954 
; | graphics tablets. 
ATTACHING THE TABLET 


Figure 3-7 illustrates how to plug the cables into the 
graphics tablet interface. The cable from input device 
(stylus, one-button, or four-button cursor) goes into the 
top connector in the interface: the cable from the upper 
left corner of the tablet goes to the middle connector; 
and the cable from the lower right corner goes to the 
bottom connector. 


It is important to plug the correct cable into the correct 
outlet. If they are crossed, the tablet will not function 
properly. 


THE STYLUS 


There are two different kinds of fillers for the stylus. 
One is a ballpoint filler, the other filler is a “blank” so it 
won't draw lines. You can use either of these fillers, 
depending on your needs. 


To change the filler, unscrew the bottom part of the 
Stylus just as you would a ballpoint pen. Gently pull the 
filler straight down. Be careful not to break either of the 
two probes (Figure 3-8). Insert the other filler and 
screw the stylus back together. 
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TABLET 
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Figure 3-7. How to Attach the Tablet. 


3673-28A 


Figure 3-8. Taking the Stylus Apart. 
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HARDWARE OPTIONS & PERIPHERALS 


POSITIONING THE PRECISION GRID 


The precision grid is an optional accessory to the 
graphics tablet. If you have one, the grid can be used to 
help you enter data more precisely. 


The procedure for positioning the grid on the tablet is 
included in the 4110 Series F13/14 Graphic Tablet 
Instruction Manual. 


CLEANING THE TABLET SURFACE 


Clean the tablet as often as necessary, using a damp 
cloth and a mild detergent, such as window or glass 
cleaner. Do not immerse the tablet in water or get it too 
wet. Never use a cleaner that contains hydrocarbons, 
since they will disolve the tabiet surface. 


RESTORING THE TABLET BIAS 


About once a week you should use the following 
procedure to restore the tablet’s magnetic bias. You 
can use this procedure more often if the tablet begins 
to relay incorrect data or if the graphics cursor moves 
erratically. 


1. Turn the terminal off and unplug it. 
2. Disconnect the tablet from the interface. 


3. Pull the magnet across the tablet from the upper 
left corner towards the lower right corner ina 
single, smooth motion (Figure 3-9). Wipe the entire 
surface in about two or three seconds. 


4. Connect the tablet again, plug the terminal back in, 
and turn the terminal back on. 


You should store the magnet away from the tablet and 
other magnetically sensitive items (such as flexible 
disks and magnetic tapes). 


Figure 3-9. Restoring the Tablet’s Bias. 
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HARDWARE OPTIONS & PERIPHERALS 


HARDCOPY UNITS 
The 4114 terminal is compatible with the TEKTRONIX For more details on ihe HARD COPY key see Section 2 
4631 and 4611 hardcopy units. Attach them by running of this manual. See the operator's manual for the 
the hardcopy cable from the copier to the interface in hardcopy unit for further operating instructions. 


the back of the terminal (Figure 3-10). 


The hardcopier should be running for about 10 minutes 
before you use it. After this period of time, it can make 
a good quality copy. To make a copy, press the HARD 
COPY key on the terminai or the COPY button on the 
copier. 


Figure 3-10. How to Attach a Hardcopy Unit. 
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Section 4 


GRAPHICS INPUT MODE 


Graphics input (GIN) mode allows you to send graphics 
information to a program. 


Usually a host resident program will put the terminal 
into GIN mode and prompt you for certain information. 
You can use escape sequence commands in Setup 
mode to put the terminal in GIN mode. 


The program should also prompt you concerning what 
kind of data you should enter. For example, it might tell 
you to locate a certain number of points on the screen 
(the “locate” function), to “pick” a certain “menu item” 
or part of the picture (the picking function), or to 
“stroke” (draw) something on the screen (the “rubber 
banding” or “inking” functions). 


The devices that can be used to send graphics 
information to a program (GIN devices) are: 


@ the terminal’s thumbwheels 
@ a 4662 or 4663 plotter 
@ agraphics tablet 


An explanation of how to position the graphics cursor 
with each input device and how to use each of the 
functions is included in this section. 


THE PICK FUNCTION 


A program may be written such that you are to choose 
between several actions. This list of actions is called 
the “menu.” The program would instruct you to “pick” 
the desired action. To do so, position the graphics 
cursor near the description of the appropriate action. 
The way that you signal the program that the cursor is 
at the position you want to “pick” depends on the input 
device you are using. They are each described later in 
this section. 


You may also be asked to pick a part of the picture to 
be moved, enlarged, reoriented, or changed in some 
way. Again, you would position the graphics cursor 
near the object and signal the program that the cursor 
is at the location you want to pick. 
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THE LOCATE FUNCTION 


Move the graphics cursor to the appropriate point on 
the screen. When it is properly located, signal the 
program that you have located the cursor. The input 
device sends the coordinates of that point to the 
program, and it is acted on accordingly. 


THE STROKE FUNCTION 


The graphics tablet allows you to draw lines as you 
move the stylus along the surface of the tablet. (The 
terminal draws lines between points when it is using 
inking but the lines appear only on the screen, they are 
not saved, 


INKING 


As you locate points on the screen, lines between 
these points may be drawn. If this occurs, the terminal 
is using the “inking function.” 


RUBBER BANDING 


When you move the cursor a line may “follow” the 
graphics cursor. One end of the line is anchored at the 
last point and the other end of the line is attached to 
the graphics cursor. This function is called “rubber 
banding.” It allows you to draw a line more precisely 
from one location to another. 


GRIDDING 


The program may also specify that an invisible “grid” 
be in effect on the screen. When a grid is active, you 
can only locate the cursor on points where the vertical 
and horizontal lines of the grid intersect. This allows 
you to precisely position the cursor when it is neces- 
sary to draw lines that intersect at a 90 degree angle. 


There is a setup command called GRIDDING which 
allows you to easily establish a grid for the input 
device. See Section 6. 


When you move the graphics cursor it may ‘jump” from 
one point to the next. If this happens, you will know that 
gridding is in effect and the cursor is moving between 
points on the grid. 
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GRAPHICS INPUT MODE 


USING THE TERMINAL’S THUMBWHEELS 


When the terminal is in GIN mode, a graphics cursor 
appears on the screen. The default is the “crosshair 
cursor’ (Figure 4-1). However, the program can select 
another graphics entity to be the graphics cursor. 


Position the graphics cursor with the thumbwheels 
(Figure 4-2). As the arrows indicate, the top 
thumbwheel moves the graphics cursor up and down 
and the bottom thumbwheel moves it back and forth 
across the screen. 


CROSSHAIR 
CURSOR 


If you hold the SHIFT key at the same time as you 
rotate a thumbwheel, the cursor moves more slowly so 
you can position it more precisely. 


When you have positioned the graphics cursor where 
you want it, you send the location of that point to the 
program by pressing any alphanumeric key. When you 
press the key, the crosshair cursor blinks momentarily 
as the point is transmitted to the program. Do not press 
the RETURN key, as that causes invalid data to be 
transmitted. 


Figure 4-1. The Crosshair Cursor. 


USING THE TABLET 


When you use a graphics tablet for a GIN device the 
graphics cursor will be visible on the screen. The 
crosshair cursor (Figure 4-1) is the default graphics 
cursor, but the program can select any graphic entity 
as the cursor. The applications program should inform 
you what is the graphics cursor if it is not evident. 


When the tablet is active, you can use one of three 
input devices: the stylus, a single button cursor, and a 
four button cursor (Figure 4-3). 


You can locate points in an 11” by 11” square on the 
smaller tablet (Option 13) and a 30” by 40” area on the 
larger tablet (Option 14). This is called the “active 
writing area.” In both cases the center of the active 
writing area is the center of the tablet. 
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Figure 4-2. The Thumbwheels. 
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THE STYLUS AND ONE-BUTTON CURSOR 


Hold the stylus as you would a ballpoint pen, with the 
tip resting on the tablet. The crosshair cursor on the 
terminal screen tracks with the stylus as you move it. 
The tablet can keep track of the stylus as long as it is 
with 5/32 of an inch of the tablet surface. 


Lay the cursor flat on the tablet surface with the button 
facing up. As you move the cursor along the surface of 
the tablet, the graphics cursor tracks with it. 


For ihe pick and iocate functions, when you locate the 
appropriate point on the tablet or terminal display, 
press down on the stylus. The stylus’ tip moves slightly 
and the graphics cursor blinks momentarily as the 
point is transmitted to the applications program. For the 
cursor, press the button to pick or locate a point. 


For the stroke function, press the styius or cursor 
button down and move the stylus or cursor across the 
tablet surface as if you were drawing on it. The number 
of points transmitted to the program depends on the 
setting of the TBFILTER command (see Section 6). 


PRECISION 
GRID 


STYLUS 


GRAPHICS INPUT MODE 


THE FOUR-BUTTON CURSOR 


Lay the cursor flat on the tablet surface with the 
buttons facing up. As you move it along the surface of 
the tablet, the cursor tracks with it. 


The functions of the four buttons can be defined by the 
applications program. For example, one button might 
cause inking to be used, another button may erase the 
line between the next two points, the third could 
impiement the stroking function, and so on. The 
applicatons program should inform you how to use the 
butions. 


If the buttons are not programmed, you can press any 
of the four buttons to transmit the current location of 
the graphics cursor to the applications program. 


4-BUTTON 


1-BUTTON CURSOR 


CURSOR 


Figure 4-3. The Option 13 Graphics Tablet. 
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GRAPHICS INPUT MODE 


USING THE 4662 OR 4663 PLOTTER 


The 4662 and 4663 plotters can also be used as For additional operating instructions, see the 4662 or 
graphics input devices (Figure 4-4). Use the plotter’s 4663 Operator’s Manual. 

joystick to position the pen at the appropriate location. 

To indicate to the program that you have located the 

point you want and you are using a 4662, press the the 

plotter’s CALL button until the plotter beeps one time, 

then release it. If you are using a 4663 plotter, press 

the plotter’s DRAW POINT button. 


Figure 4-4. The 4114 and 4663 Plotter. 
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Section 5 


COMMUNICATIONS OVERVIEW 


Some communications parameters are crucial. For 
example, if the host and terminal have conflicting baud 
rates, there can be no communications. Similarly, if the 
host checks for even parity and the terminal is set up 
for odd parity, there will be communications problems. 
It is important for the operator to have some under- 
standing of basic communications considerations to 
avoid some obvious problems. 


Tabie 5-1 lists ali of the setup commands which deal 
with communications. Commands under the heading 
“Standard Commands” are standard for the terminal. 
Those under the heading “Optional Commands” are 

part of the communications option (Option 01). 


The concepts which these commands introduce are 
discussed in the rest of this section. 


This section provides an overview of the terminal’s 
communications modes. For detailed information on 
these subjects, see the 4114 Host Programmer's 
Manual, a system manual for your host, or a systems 
programmer for your host. 


In most cases communications parameters are set by 
program control and not by an operator. However, since 
there are setup commands which allow these condi- 
tions to be set by an operator, the concepts are 
introduced in this manual. And, there are some com- 
mands (such as BAUDRATE) which would usually be 
set by the operator. 


Table 5-1 
COMMUNICATIONS COMMANDS 


Standard 
Commands 


BAUDRATE Specifies transmit and receive baud 
rates 

BREAKTIME Specifies length of break 
transmission 

BYPASSCANCEL Specifies bypass cance! character 

EOFSTRING Specifies end of file string 

EOLSTRING Specifies end of line string 

EOMCHARS Specifies end of message characters 

FLAGGING Specifies whether flagging is used 
and what kind 

PARITY Specifies how parity is checked 

PROMPTMODE Specifies whether or not terminal is 
in Prompt mode 

PROMPTSTRING Specifies prompt string 

QUEUESIZE Specifies size of terminal’s input 

; queue 

STOPBITS Specifies number of stop bits used 

XMTDELAY Specifies time terminal waits after 
transmitting an end of message char- 
acter before resuming transmission 

XMTLIMIT Sets upper limit of terminal’s 


tranmission rate 
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Explanation Optional 
Commands 


Explanation 


BCONTINUECHARS 
BENDCHARS 
BHEADERS 


Specifies block continue characters 


Specifies block end characters 


Specifies block header sequences 


BLENGTH Specifies block length 

BLINELENGTH Specifies maximum line length for 
Block mode 

BLOCKMODE “Arms” or “disarms” the terminal for 
Block mode 

BMASTERCHARS Specifies block master characters 

BNONXMTCHARS Specifies block non-transmittable 
characters 

BPACKING Specifies manner in which blocks 
are packed for transmission and re- 
ceiving 

BTIMEOUT Specifies how long terminal waits 

| before retransmitting previous block 
DUPLEX Specifies Duplex mode 
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STANDARD COMMUNICATIONS 


The terminal’s standard communications feature all 
facilities necessary to support |/O with most host 
computers. These include: 


@ full duplex 

@ RS-232-C compatibility 
@ Prompt mode 

@ flagging 


“Full duplex” implies that the terminal can send and 
receive data at the same time. Whether or not this 
actually occurs depends on whether the host is 
capable of sending and receiving data simultaneously. 


Each character is transmitted as soon as you press the 
key. Likewise, each character is processed as soon as 
it is received from the host. 


“Prompt mode” and “flagging” are explained later in 
this section. 


COMMUNICATIONS CONCEPTS 


The following concepts and terminology apply to 
standard communications, as well as communications 
in Block mode, and half duplex. 


BAUDRATE 


The baud rate is the rate at which data is transmitted 
between the host and the terminal. As used in this 
manual, the term “baud rate” means “bits per second.” 
Transmission at a rate of 9600 baud means 9600 bits 
per second, or approximately 960 characters per 
second. 


The factory default baud rate is 2400. You can use the 
setup command BAUDRATE command to modify it. The 
transmit and receive baud rates can be set indepen- 
dently. 


It is important that the terminal and the host be set to 
communicate at the same baud rates. If not, data will be 
misinterpreted or not communicated at all. You can use 
the STATUS command, as explained in Section 6 of . 
this manual, to determine the terminal's current trans- 
mit and receive baud rates. 
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PARITY 


The accuracy of the transmission of data can be 
verified in many different ways. One way is to check 
the “parity” of each character after it is sent. 


Each character is coded into eight binary digits (bits) 
with a value of 0 or 1. The first seven bits define the 
character. The eighth character is often used for a 
parity check. 


“Even” parity means that the sum of the bits is always 
even. That is, when the sum of the bits of a character 
add to an even number, the eighth bit is set to 0; if the 
sum is an odd number, the eighth bit is set to 1. 


Similarly, “odd” parity means the sum of the bits must 
always be an odd number. 


“None” means that the parity is always 0. “High” 
means that the parity bit is always set to 1. “Data” 
means that the eighth bit is part of the character being 
transmitted instead of being used as a parity check. 


The terminal’s parity must always be set to match the 
host computer’s needs. The terminal ignores the parity 
bit on characters the host transmits to it. 


FLAGGING 


It may be necessary for the terminal and the host to be 
able to inform each other when they are ready to 
receive data and when transmission should be 
temporarily suspended. 


For example, the terminal has an input queue into 
which data is collected until it can be processed. When 
the input queue is full, any additional data which the 
host tries to send to the terminal would be lost. 


However, the terminal can send a character (called a 
“flag”) to stop data transmission from the host when its 
input queue is full. When there is more room in the 
queue, another flag is sent to tell the host to resume 
transmission. 


Since this is not useful on all hosts and since some 
hosts require different kinds of flagging, the setup 
command FLAGGING allows the operator or a program- 
mer to define the flagging parameters. 
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QUEUESIZE 


The terminai processes data as soon as it receives it 
from the host. However, if data is coming to the terminal 
at a high baud rate, it may not be able to process it as 
quickly as it is received. 


When the terminal is in Block mode, it waits until it has 
received a complete block of data before it begins to 
process it. 


in both of these cases, the terminal stores data in an 
input queue until it can process it. 

The size of the queue can be specified by the 
QUEUESIZE command. Its size depends on the host 
computer, the rate of transmission, the kind of com- 
munications link used, and other installation dependent 
factors. The factory default is 300 bytes. 


AMTLIMIT 


Sometimes the rate at which a host computer can 
effectively receive data is less than the maximum 
possible for the baud rate at which the communictions 
port is specified. 


For example, a time-share host may not be able to 
receive data at 9600 baud, even though you are logged 
onto a 9600 baud port. In such a case, you could leave 
the terminal’s transmit baud rate setting at 9600 but 
set the transmit limit parameter (established by the 
XMTLIMIT command) to a level with which the host can 
cope — perhaps 8000. The terminal then sees to it that 
data is not transmitted at a rate faster than 8000 baud. 


The baud rate is not actually changed, but the charac- 
ters transmitted are spaced apart so that the number 
transmitted per second is the same as if the baud rate 
were the transmit limit rate. 


The factory default transmit limit is 19200 baud. If your 
host can receive data at speeds up to 19200 baud, you 
do not have to be concerned with the transmit limit. 
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COMMUNICATIONS OVERVIEW 


BREAKTIME 


There will be occasions when you need to interrupt the 
transmission of data from the host or halt a host 
program. One way to do so is with the BREAK key. 


The BREAK key sends an interrupt transmission to the 
host. The length of the interrupt is set by a command 
called BREAKTIME. The factory default BREAKTIME 
parameter is set to 200 ms. However, it may be need to 
be ionger or shorter — and on some hosts you may not 
want to use the BREAK key at all. In that case, 


+ om 
BREAKTIME can be set to 0 ms. 


EOLSTRING 


The “end of tine string” indicates the end of the 
transmission of a line of data. it is sent by the terminal 
at the end of (or during) transmissions generated by 
the terminal. 


The factory default termination string is the “carriage 
return.” This works for all hosts which interpret the 
Carriage return as the end of a particular line of data. 


Since you explicitly inform the host of the end of a line 
by typing a termination string (carriage return) when 
entering data from the keyboard, no special action 
must be taken by the terminal. 


However, sometimes the host requests information 
from the terminal which is sent in a different format and 
requires no operator interaction. For example, the 
program may request a report of error messages or 
some graphics input data. In such cases, the terminal! 
sends an end of line character to the host to indicate 
the end of a transmission. 


The EOLSTRING command (see Section 6) is used to 
change the end of string. 
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XMTDELAY 


The terminal can be set to wait for an interval of time 
after it receives data from the host before it begins to 
transmit. Whether or not this is desirable or necessary 
depends on your host. 


The interval for the terminal is set by the XMTDELAY 
command. The delay can be set from 0 to 65535 ms 
(which is about one minute). The factory default is O. In 
some cases, for example, a delay of 50 or 100 ms is 
necessary to allow a modem or other transmission 
equipment to “turnaround.” 


EOFSTRING 


When you are transferring files between the host and 
terminal, it is necessary to know when the file transfer 
is complete. The “end of file” indicator is a string of 
from one to ten ASCII characters. 


When a data file is transferred from the host to the 
terminal using a COPY or SPOOL command, the host 
must send the end of file string when it reaches the end 
of the file. The terminal sends the same string to the 
host when it reaches the end of a file it is transferring 
to the host. 


This string is defined by the EOFSTRING command. It 
should be set to whatever the host computer sends 
when it reaches the end of a file. It is best to set this to 
the null string except when you are actually 
transmitting files, since the string is ignored by the 
terminal whenever it is detected in a host transmission. 


STOPBITS 


Each character sent between the host and terminal is 
coded into eight binary digits (bits) of data. Each of 
these eight bit codes is called a byte. 


After sending a byte of data, the host or terminal sends 
one or two extra bits to indicate the end of a byte. 
These extra bits are called “stop bits.” 


The terminal includes a STOPBITS command which 
allows you to specify whether the terminal sends one 
or two stop bits at the end of each byte. The factory 
default is 1. 
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EOMCHARS 


The “end-of-message” characters are communications 
“turnaround” characters. ; 


When the terminal is transmitting to the host and it 
encounters an end-of-message character, it transmits 
that character and then pauses for a period of time 
before resuming transmission. 


The period of time the terminal waits is specified by the 
XMTDELAY command. 


If the terminal is in Prompt mode, when it sees the end 
of message character it knows to wait for a prompt 
string from the host before resuming transmission. 
When the terminal is in Block mode, it first transmits 
the block, then it waits for XMTDELAY and for the next 
prompt. 


The end-of-message characters are set by the EOM- 
CHARS command. The factory default characters are 
CARRIAGE RETURN and NUL. Since ‘. (null) is 
ignored, setting both end of message characters to NE 
disables this feature. 


BYPASSCANCEL 


There are many characters which are transmitted 
between the host and the terminal which you do not 
need to or even want to see. For example, graphics 
input characters and other report characters are not 
important to an operator, yet they must be processed 
by the terminal. 


Instead of being displayed, these characters are auto- 
matically “bypassed.” The “bypass cancel character” 
is used by the terminal to assure that the correct 
characters are bypassed and that the display of 
characters is resumed appropriately. 


This character is specified by the BYPASSCANCEL 
command. The factory default is the linefeed character. 
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COMMUNICATIONS OVERVIEW 


. PROMPT MODE 


The PROMPTMODE command can be used to initiate 
and terminate Prompt mode. 


All of the communications parameters detailed under 
the “Standard Communications” heading are also valid 
when the terminal is in Prompt mode. ° 


In Prompt mode, all data to be transmitted to the host is 
Kept in an output queue. It is sent wnen a prompt is 
received from the host. When the prompt is received 


ranami 
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be transmitted until an “end of message” character 
(specified by the EOMCHARS command) is sent. 


The “end of message” character halts transmission of 
data and is also an indication to the host that 
transmission is over until it sends another prompt. 


The PROMPTSTRING command is used to specify the 
prompting string. The prompt string can be from one to 
ten characters, and it must conform to the actual 
prompt used by the host. 


BLOCK MODE (OPTION 01) 


In Block mode, data is packed into blocks and 
transmitted as a unit. After each block is transmitted, 
there is a response from the device which received it 
before another block is sent. This process verifies the 
accuracy of the transmission of each block. If there 
were any errors in the transmission, the same block is 
retransmitted until it arrives in a correct form. 


Because of this format, Block mode allows easier 
transmission of full ASCII or binary code. It also- 
provides error detection and automatic retransmission 
of bad data blocks. 


Block mode can be used at the same time as Prompt 
mode and in Full Duplex or Half Duplex mode. 


Specific details concerning how Block mode works are 
very complex. The 4114 Host Programmer’s Reference 
Manual! contains more information on Block mode. 


The BLOCKMODE command arms the terminal for 
Block mode. The terminal actually enters Block mode 
when it receives the first block header. 


The following definitions are an introduction to the 
concepts of block mode communications. They are 
included because there are set up commands which 
specify these parameters. The syntax of each 
blockmode communications command is detailed in 
Secton 6. 
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BLENGTH 


The maximum length of each block, for both 
transmitting and receiving, is specified by the 
BLENGTH command. 


The best size for a block length depends on several 
factors. For example, after each block is transmitted by 
either the terminal or the host, a response is required 
before the next block is sent. Therefore, the shorter the 
block, the more time is spent responding to blocks sent 
and received. However, for a long block, more time is 
spent retransmitting a block if that is necessary. 


The factory default is 256 bytes. 


BHEADERS 


The start of each line of data in Block mode is 
indicated by a header sequence. The header sequence 
is a String of fromm one to ten ASCIi characters. The first 
character in the sequence cannot be used elsewhere 
in the sequence; and the sequence cannot include any 
character which is part of the prompt string. 


The header sequence is specified by the BHEADERS 
command. The factory defaults are HEADTX, HEADRX. 
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BCONTCHARS 


A block of data may be one or more lines long. If a 
block extends to more than one line, each line ends 
with a block continue character, indicating that more 
lines follow. There can be different block continue 
characters for transmitting and receiving. 


The block continue characters can be specified by the 
BCONTCHARS command. The choice of characters 
depends on what characters the host expects. 


The default block continue character is ampersand (&) 
for both transmit and receive. 


BENDCHARS 


A “block end” character specifies the end of a block. 
The block end character can be specified with the 
BENDCHAR command. The block end character must 
be compatible with the host software. 


BLINELENGTH 


The block line length specification is the longest line 
that can be transmitted from the terminal that will not 
overrun the host’s input buffer. Therefore, it should not 
be set to a value which exceeds the input buffer of the 
host. The default value is 70. 


There is no maximum line length for the terminal, since 
it can receive a line of any length. 


The block line length parameter is set by the BLINE- 
LENGTH command. 
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BPACKING 


There are various data packing schemes available for 
host systems with limited transmission capabilities. 
That is, if your host cannot transmit full 7-bit ASCII or 
8-bit binary data, the data can be coded (packed) into a 
reduced character set. 


The data packing scheme is specified by the BPACK- 
ING command. 


BTIMEOUT 


When the terminal sends a block of data, it waits for a 
response from the host to acknowledge that it has 
received that block intact. If the terminal does not 
receive the appropriate response within a period of 
time or if it receives an erroneous response the 
terminal retransmits that block. It pauses again, and 
will repeat the sending of the block until it is acknowl- 
edged. 


The period of time the terminal waits before sending 
the block again is specified by the BTIMEOUT 
command. 


Be sure that the specified timeout period is longer than 
may be encountered due simply to a busy host. 
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BNONXMTCHARS AND BMASTERCHARS 


There are several charactes which cannot be transmit- 
ted in Block mode. 


For example, if “A” is the block end character, it cannot 
be transmitted as an “A,” since whenever the terminal 
or host sees “A,” it assumes it indicates the end of a 
block. 


COMMUNICATIONS OVERVIEW 


Therefore, whenever “A” or any other restricted char- 
acter must be sent, the terminal or host instead sends a 
master character, followed by a substitute character. 
When that two-character combination is received, it is 
decoded into the intended character. 


This is done automatically by the terminal and host. 
However, all non-transmittable characters must be 
specified by the BNONXMTCHARS command. The 
character used as the master character is specified by 
the BMASTERCHARS command. 


HALF DUPLEX MODE 


The standard mode of communication is full duplex, 
including when the terminai is in Prompt mode or Block 
mode. In full duplex, the terminal and host can both 
send and receive data ai the same time. 


in haif dupiex, either the terminal and host send data, 
but not at the same time. 
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All of the standard communications commands are 
meaningful in half duplex mode. 


In half duplex with Supervisor Communicatons mode, 
the host always controls the flow of data. That is, the 
host decides when the termina! or host sends or 
receives data. 
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Section 6 


SETUP COMMAND DICTIONARY 


This section contains a detailed explanation of Setup 
mode and of each setup command. Table 6-1 provides 
an overview of the setup commands in a functional 
organization. The rest of this section is a detailed 
explanation of each command, in alphabetical order. 


To put the terminal into Setup mode, press the key 
labeled SET UP (Figure 6-1). The terminal must be in 
Setup mode to execute setup commands. 


Setup commands allow you to establish the terminal's 
operating environment and to use peripherals attached 
to the terminal. For example, setup commands are used 
for establishing communicatons rates, inquiring about 
the terminal’s status, determining what levels of errors 
the terminal should display, and programming special 
meanings (macros) into keys. 


SETUP COMMAND FORMAT 


A setup command starts with a command word, usually 
has one or more parameters, and ends with a carriage 
return. 


The “command word” is a descriptive English-like word 
indicating what the command does. A command word 
can be entered in either upper or lower case; it can be 
spelled out completely or abbreviated to as few 
characters as are necessary to distinguish it from other 
command words — usually two or three characters. 
Whatever amount of the command word is typed must 
be spelled correctly or an error results. 


in most cases a command includes one or more of six 
different parameter types. (Parameters are explained in 
more detail with the individual commands.) The param- 
eter types are: 


@ single characters 

keywords 

delimited character strings 
un-delimited character strings 
key specifiers 


integers 


| 3673-35 | 


Figure 6-1. The SET UP Key. 


4114 OPERATOR'S 


SET UP COMMANDS 


Keyword parameters can be abbreviated to as few 
characters as are required to distinguish them from 
other keywords in the same command. 


A “key specifier’ parameter can be entered by press- 
ing the appropriate alphanumeric key or by entering its 
ADE (ASCII Decimal Equivalent) value. 


A carriage return terminates a line and causes the 
command on that line to execute. One setup command 
can be entered per line. 


A “line” can be up to 130 characters long. If you 
continue typing when the cursor is at the right edge of 
the screen or dialog area, the cursor wraps around to 
the left margin of the next line on the screen. !t is stil! 
the same line until you enter a carriage return. If you 
continue to type after you reach the maximum of 130 


characters, the terminal bell rings each time you press 


any key except RETURN, the “character delete” key, or 
the “line delete” key (see the EDITCHARS command 
later in this section). 


CORRECTING A MISTAKE IN 
SETUP MODE 


You can backspace to edit one or more characters on a 
particular line by pressing the “character delete” key. 
You can discontinue the current line and start a new 
line by pressing the “line edit” key (see the ED- 
ITCHARS command later in this section for details). 


If you enter a carriage return to terminate a command 
and there is 4 mistake in the command iust entered, an 
error message is displayed on the next line. When this 
happens, you can look up the meaning of the error 
message in Appendix A and reenter the command 
correctly. 


SETUP MEMORY 


The terminai stores many setup command parameters 
in “setup memory.” When the terminal is turned on, it 
remembers the parameters which are stored in setup 
memory. 


In Table 6-1, command names preceded by a 
superscript are stored in setup memory. In the explana- 


tions of the commands, “(Memory)” is printed immedi- 
ately following the statement of the purpose of the 
command, to indicate that the command's parameters 
are saved in setup memory. 


You can use the STATUS command to determine 
current status of the terminal or a particular parameter, 
as explained later in this section. 


HOW SETUP INTERACTS WITH OTHER FUNCTIONS AND MODES 


Host Communications. Communication to the host is 
suspended when the terminal is in Setup mode. Data 
sent from the host to the terminal is stored in a queue 
in the terminal during Setup mode and processed when 
the terminal exits from Setup mode. (The size of the 
input queue is determined by the QUEUESIZE setup 
command.) 


GIN Mode. When the terminal enters Setup mode, GIN 
mode is suspended. The GIN cursor disappears and 
graphics input data is not communicated. When you 
exit from Setup mode, the cursor reappears and GIN 
mode continues. Graphics input is explained in Section 
4. Also see the 4114 Host Programmer's Reference 
Manual and the 4110 Series Command Reference 
Manual. 
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Control Characters. If you enter a control character 
when the terminal is in Setup mode, the control 
character is displayed rather than executed. Control 
characters are displayed in a coded two-character 
abbreviation called ‘“‘snoopy” characters. 


Programmed Keys. If the terminal is in Setup mode 
and you ;::8ss a key which has a macro programmed 
into it (see DEFINE, later in this section), the macro is 
expanded as usual. 


Local Mode. When the terminal is in both Setup and 
Local modes at the same time, Setup mode takes 
priority. 


4114 OPERATOR'S 


SET UP COMMANDS 


ESCAPE SEQUENCE COMMANDS 


Setup commands are a subset of the terminal’s com- 
mand repetoire. Setup commands are those which are 
used most often and which an operator will find most 
useful. Setup mode also allows you to execute 


commands for which there is not an English-iike 
command word. These are called “escape sequences,” 
since the first character of these commands is the 
“escape” character. (See Appendix C.) 


COMMAND SYNTAX CONVENTIONS 


Figure 6-2 illustrates the format used in presenting the 
syntax of the terminal’s setup commands. 


The beginning of the explanation of each command is 
at the top of a column. The column’s heading is the 
command name. Immediately after the command name 
is a brief explanation of the purpose of that command. 
Following that, the word “(Memory)” appears if the 
command's parameters are saved in setup memory, 
and the option number if this command is part of a 
terminal option. 


The next line shows the command in its correct syntax, 
according to the following conventions: 


® The command name is shown first, in all capital 
letters, and bold faced type. You can enter the 
command name in lower case if you prefer, and can 
abbreviate the command name to as few characters 
as are necessary to distinguish it from other com- 
mands. 


@ Words that must be entered as shown, such as 
command names and keywords, are shown in bold 
faced type. 


© Parameters in regular faced type are descriptive of 
the kind of information that parameter specifies. 


e@ Each parameter is separated by one or more spaces 
or a comma. You can separate by one comma and a 
space or by multiple spaces. Muitipie commas have 
a special meaning. 
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@ Parameters in square brackets are optional. 
@ You must chocse one parameter when two or more 
are stacked and in curly brackets. 


@ You may choose one parameter when two or more 
are stacked within square brackets. 


@ When you can choose between a number of different 
variations, the presentation of the syntax is simoli- 
fied by showing it in two or more statements. 


COMMAND parameter, [parameter], { parameter , 
[parameter], ‘parameter } 


parameter explanation .... 
parameter explanation .... 


Figure 6-2. Format of Setup Command Syntax. 
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SETUP COMMAND SUMMARY 


Table 6-1 lists and briefly describes all setup com- 


mands. It also indicates the factory default parameters, 
which commands are part of options to the terminal, 
and those commands whose parameters are stored in 
setup memory. The factory default is shown for each 
parameter because that is what the terminal defaults to 
if the setup memory fails, or is changed by the addition 


or deletion of a circuit board. 


Function 


*®ALPHASIZE 
*CRLF 


General Terminal 
Operation 


*ECHO 
*EDITCHARS 


*ERRORLEVEL 
*"GRIDDING 


*IGNOREDEL 
*LFCR 

®MARGIN 
*PAGEFULL 
*PICKAPERTURE 
*REOM 


*RLINELENGTH 
SNOOPY 
STATUS 


“Saved in Setup Memory. 
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NOTE 


In this table, the information in parenthesis 
AFTER the commands indicates the following: 


® 01= Extended Communications option 
© 10= Three Port Peripheral option 
© 13/14= Graphics Tablet options 


® 42/43= Flexible Disk options 


Table 6-1 
SETUP COMMANDS 


Factory 
Default 


Purpose 


Specifies character size. 


Sets or terminates “carriage return implies 
line feed.” 


Sets local or remote echo. 


Defines character delete, line edit, and 
“literal” characters. 


Sets error reporting threshold. 


Establishes an invisible grid on the screen 
for GIN mode. 


Specifies whether or not the “delete” char- 
acter is ignored. 


Sets or terminates “line feed implies car- 
riage return.” 


Specifies the number of margins into which 
the screen is divided for the display of text. 


Determines action to be taken when page 
full condition occurs. 


Determines size of aperture used for 
picking function. 


Determines use of end of message charac- 
ter for GIN mode. 


Determines GIN report line length limit. 
Sets or terminates “snoopy” mode. 


Displays the terminal’s status. 
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Function 


Dialog area 
control 


Keyboard control 


Data transfer 
control 


Flexible disk 
control 


Table 6-1 
SETUP COMMANDS (cont) 


Factory 
se Default 


*DABUFFER 
*DACHARS 


®DAENABLE 
@NALINES | 5 | 
*DAMODE Replace 
@DAPOSITION 0, 0 
DAVIS No 
| DEFINE | | 
| @KEYEXCHAR | De | 
LOCKKEYBOARD No 


PCOPY(10) 


PLOT(10) 


SAVE 


SPOOL 


DELETE(42/43) 
DIRECTORY (42/43) 
FORMAT (42/43) 


PROTECT(42/43) 


RENAME (42/43) 


®8Saved In Setup Memory. 


4114 OPERATOR'S 


@ 


SET UP COMMANDS 


Sets maximum size of dialog buffer in lines. 


Sets maximum number of characters per 
line in dialog buffer. 


Specifies whether or not alpha text is sent 
to the dialog area. 


Specifies the visible portion of the dialo 


portion of 1a1og 
buffer. 


Sets Overwrite or Replace mode in dialog 
area. 


Sets position of dialog area. 


Sets visibility of the dialog area. 


Assigns macro to key or integer. 
Specifies the key execute toggle character. 
Locks the keyboard. 


Copies data from one device to another. 


Reads a file and executes it as a command 
file. 


Copies between peripheral devices and the 
host. 


Plots currently visible segments to speci- 
fied device. 


Saves macro or segment io a disk fiie. 


Copies data from one device to another, 
leaving the terminal free to do other jobs at 
the same time. 


Halts the spooling operation. 


Deletes a file from the disk. 
Displays a directory of the disk. 


Prepares a disk so files can be created on 
it. 


Prevents the the terminal from writing to a 
disk or to a specific disk file. 


Renames a disk file. 
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Table 6-1 
SETUP COMMANDS (cont) 


Factory 
Command Default 


®BAUDRATE 2400, 2400 
*BREAKTIME 


Function 


Standard 
Communications 


*BYPASSCANCEL 
4EOFSTRING 
*EOLSTRING 
*®EOMCHARS 
*FLAGGING 


®PARITY 


*PROMPTMODE 


*QUEUESIZE 
*STOPBITS 


*XMTDELAY 


®XMTLIMIT 


Three port PASSIGN(10) 
peripheral 
interface control *PBAUD(10) 


*PBITS(10) 
®PEOF(10) 
*PEOL(10) 
*PFLAG(10) 
PORTSTATUS(1 0) 
®PPARITY(10) 


®8Saved In Setup Memory. 
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Purpose 


Sets transmit and receive baud rates. 


Defines length of break transmission in 
milliseconds. 


Sets bypass cancel character. 
Defines end of file string. 
Defines end of line string. 


Defines end of message characters. 


Specifies kind of flagging done by the 


terminal. 


Specifies the kind of parity sent from the 
terminal. 


Specifies whether or not the terminal is in 
Prompt mode. 


Sets size of terminal input queue. 


Specifies number of stop bits the terminal 
uses. 


Specifies length of time terminal waits after 
receiving end of message character. 


Specifies maximum transmit rate for the 
terminal. 


Assigns a device to a port. 

Sets baud rate for a port. 

Sets the stop and data bits for a port. 
Defines the end of file string for a port. 
Defines the end of line string for a port. 
Establishes type of flagging for a port. 
Returns status on specified port. 


Establishes the parity checking used on a 
port. 
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Table 6-1 
SETUP COMMANDS (cont) 


Factory 
Default 


Function Command Purpose 


Optional @BCONTINUECHARS(01) & & Specifies block continue characters. 


Communications 
@BENDCHARS(01) 
4BHEADERS(01) 


$ $ 
‘HEADTX’ 


Specifies end of block characters. 


Specifies biock header sequences. 


| 'HEADRX’ | 

@BLENGTH(01) 256 256 Specifies block length. 

@BLINELENGTH(01) 70 Specifies line length for Block mode 
transmission. 

@BLOCKMODE(01) No Specifies whether or not terminal is armed 
for Block mode. 

| ®BMASTERCHARS(01) | # # Specifies master characters for Block 

mode. 

@BNONXMTCHARS(01) '#S8' '#S8' Specifies non transmittable characters for 
Block mode. 

®BPACKING(01) 7676 Specifies manner in which blocks are 
packed. 


@BTIMEOUT(01) Specifies how long terminal waits before 


retransmitting previous block of data. 


*DUPLEX(01) Specifies which Duplex mode the terminal 


is in. 


*TBFILTER(13/1 4) 
®TBHEADERCHARS(1 3/14) 


Graphic Tablet Specifies tablet data filtering. 


Specifies tablet stroke header characters. 


TBSTATUS(1 3/14) Specifies if status byte is sent when input 


device is lifted from tablet surface. 


Saved in Setup Memory. 
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ALPHASIZE 


Specifies the size of alphanumeric (non-graphics) text. 
(Memory) 


ALPHASIZE scale, xgap, ygap 


scale is an integer parameter representing the 
scale factor of the character. Each vector in the 
character is multiplied by “scale” as it is drawn. 
The factory default is 10; the valid range is from 
1-16. 


xgap is an integer parameter representing the 
distance between characters. The factory default 
is 6; the valid range is from 0-15. 


ygap is an integer parameter representing the 
distance between lines. The factory default is 28; 
the valid range is from 0-255. 


This command specifies the size of alpha text when it 
appears in either the dialog area or in graphics. 


The size of alpha text affects the location of the dialog 
area. If the dialog area is visible, the new location and 
new alpha text size becomes effective the next time the 
dialog area is made visible. if the dialog area is not 
visible, the new alpha text size becomes effective 
immediately. 


Figure 6-3 illustrates the meaning of each parameter. 
The size of the squares in the grid is determined by 
“scale” parameter. The default size is ten units. If you 
specify the scale as 16, each grid is increased 
proportionately so the character is bigger. If you 
specify two, the grids are smaller to make the character 
smaller. Notice that the character is not drawn in the 
last column of grids. This prevents characters from 
overlapping even if the inter-character gap is set to 
zero. 


The following examples (Figure 6-4) illustrate three 
text sizes. The first command fits 81 characters per 
line, the second fits 133 characters per line and the 
third fits 163 characters per line. (Within the dialog 
area, one less character per line is allowed than in the 
graphics part of the screen.) 
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Pre-Defined Text Sizes 


The 4114 has four pre-defined text sizes, which are the 
same as the four standard sizes on the TEKTRONIX 
4014 terminal. 


Table 6-2 shows how to access each size. Note that 
you must be in Local mode to use the command shown 
in the table, since Setup mode does not recognize 
commands in this format. 


Table 6-2 
PRE-DEFINED TEXT SIZES 


How to [cgutvasent T sample 


Specify | ALPHASIZE { Size 
in Local | Parameters | 
Mode 


Sample text size. 
Sample text size. 

| Sample text size. 

] Semple text size. 


Figure 6-3. Alphasize Grid. 
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BAUDRATE NOTE 


Tne ierminai’s baud rate settings must be com- 
patible with the transmit and receive baud rates 
used by the host computer. 


Specifies the transmitting and receiving baudrates for 
communications between the terminal and the host 
computer. 


(Memory) The transmit and receive rates do not have to be set to 
BAUDRATE trans, rec the same values. Also, either the transmit or receive- 

rate can be specified by an external clock while the 
other is specified by the terminal firmware. 


trans is an integer parameter specifying the baud 
rate at which the terminal transmits data. Valid The following command sets the transmit rate at 9600 
baud rates are the same as those listed for “rec.” baud and the receive rate at 2400 baud. 


A value of 1 indicates the use of an external 
device to control the transmission rate. The 
factory default baud rate is 2400. 


BAUDRATE 9600, 2400 Cr 


The following command sets the transmit baud rate to 
2400 while the receive baud rate is controlled by an 
external clock. 


BAUDRATE 2400 1 Cr 


rec is an integer parameter specifying the baud 
rate at which the terminal expects to receive data 
from the host. A vaiue of 1 indicates externai 
clocking. Valid specifications for “trans” and | 
“rec” are listed. If you enter no value for “rec,” it The baud rate parameter may be set for you by an 
is set to the same value as “‘trans.” The factory | initialization file on a flexible disk. If it is not, you may 
default is 2400. need to consult with a system programmer for your 
host computer before using this command. 
| 
| 
| 


110 
134 (sets baud rate to 134.5) 
150 
300 
600 
1200 
1800 
2000 
2400 
4800 
9600 
19200 
38400 (rates above 19200 require a flagging or 
handshaking mechanism) 


| Valid baud rates are: 
' 


This character size fits 81 characters 
ALPHASIZE 9 6 28 per line and 38 lines per page. 


This character size fits 133 characters 
ALPHASIZE 5 6 18 per line and 63 lines per page. 


This character size fite 163 characters 
e. 


ALPHASIZE 4 5 12 per line and 86 lines per pag 


Figure 6-4. Various Text Sizes. 
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BCONTINUECHARS 


Sets the line continue characters for block mode. 
(Memory) 


(Option 01) 


BCONTINUECHARS xmt, rec 


xmt is a single character representing the trans- 
mit continue character. If you do not enter a value 


for “xmt” itis set to null. Any ASCII character is 
valid; the factory default is an ampersand (&). 


rcv is an single character representing the re- 
ceive block continue character. If you do not 


Fae may)? pre ttl 


enter a value for “rev” itis set to null. Any ASCH! 
character is valid; the factory default is an 
ampersand (&). 


This command cannot be used if the terminal is already 
in or armed for Block mode. See the BLOCKMODE 
command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to null. 


The terminal sends the “xmt’” character to the host to 
indicate when a block continues to the next line. When 
the terminal receives the “rcv” block continue 
character, the terminal knows that the block it is 
receiving continues to the next line. 


The following command specifies the percent (%) as 
the transmit block continue character and the asterisk 
(*) as the receive block continue character: 


BCONTINUECHARS % * Cn 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BENDCHARS 


Sets the block end characters for Block mode. 
(Memory) 


(Option 01) 


BENDCHARS xmt, rcv 


xmt is a single character representing the trans- 
mit block end character. If you do not enter a 
value for “xmt” it is set to null. Any ASCII 
character is valid; the factory default is the dollar 
sign ($). 


rcv is a single character representing the receive 
block end character. If you do not enter a valus 
for “rcv” it is set to null. Any ASCII character is 
valid; the factory default is the dollar sign ($). 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE com- 
mand. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to null. 


The terminal transmits the “xmt” character to the host 
to indicate the last line of a transmission in Block 
mode. When the terminal receives the “rcv” character, 
the terminal knows that it is the last line of a block 
transmission. 


The following command sets the block end transmit 
character to the pound sign (#) and the block end 
receive character to the ampersand (&): 


BENDCHARS # & ‘Sr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BHEADERS (Option 01) 


Sets the transmit and receive header sequences for 
Block mode. 
(Memory) 


BHEADERS xmt®., rev. 


D. is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 


delimiter character for this command. 


xmt is a delimited character string representing 
the transmit block header sequence. Any string of 
up to ten ASCII characters can be used (restric- 
tions are listed under “rev”). The factory default 
“xmt” header is HEADTX. 


rev is a delimited character string representing 
the receive block header sequence. The factory 
default “rcv” header is HEADRX; “rcv” is set to 
null if no string is specified. Any string of up to 
ten ASCII characters can be used with the 
following restrictions: 


e the first character cannot be repeated in the 
sequence. 

® the sequence cannot include any characters 
which are part of the prompt string (see 
PROMPTSTRING). 

@ the sequence should be one that would never 

appear in normal text. 


This command cannot be used if the terminal is already 
in or armed for Block mode. See the BLOCKMODE 
command. 


if you enter just the command word and no parameters, 
both ‘‘xmt” and “rcv” are set to null. 


When the terminal sends the “xmt” sequence, it signals 
the host that a block of packed data follows immediate- 
ly. When the terminal receives the “rcv” sequence, it 
signals the terminal that a block of packed data follows 
immediately. 


The following command sets the transmit block header 
to “+ send” and the receive block header to “+ recve”: 


BHEADERS /+send/ /+receve/ °r 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BLENGTH 


Sets the block length for Block mode. 
(Memory) 


(Option 01) 


BLENGTH xmt, rcv 


xmt is an integer parameter representing the 
transmit block length. The valid range of values is 
from five to 65535 lines. The factory default is 
256. 


rev is an integer parameter which is the receive 


block length value. The values range from five to | 
65535 lines. The factory default is 256. 
This command cannot be used if the terminal is already 


armed for block mode. See the BLOCKMODE com- 
mand. 


The following command sets the block length to 100: 
BLENGTH 100 Cn 

This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 


system programmer for your host computer before 
using this command. 
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BLINELENGTH 


Specifies the maximum length line that the terminal will 
transmit in Block mode. 
(Memory) 


(Option 01) 


BLINELENGTH length 


length is an integer parameter specifying the 
maximum number of characters the terminal can 


transmit in one line in Block mode. The valid 
range is from 12 to 65535 characters. The factory 
default is 70 characters. 


This command cannot be used if the terminal is already 
armed for Biock mode. See the BLOCKMODE com- 
mand. 


The specified line length has no effect on input to the 
terminal for communications in non-Block mode. 


The following command sets the line length to 55: 
BLINELENGTH 55 Cr 

This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 


system programmer for your host computer before 
using this command. 
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BLOCKMODE 


Specifies that the terminal will go into Block mode as 
soon as it receives a block header. 
(Memory) 


BLOCKMODE 


(Option 01) 


{yes} 
{no} 


yes is a keyword parameter specifying that the 
terminal should enter Block mode when it 
receives the next block header (see BHEADER). If 
you enter just the command word and no parame- 
ter, the terminal assumes “yes” and arms itself 
for Block mode. 


no is a keyword parameter specifying that the 
terminal is not in Block mode. If the terminal is in 
Block mode when you enter this command, it 
exits from Block mode immediately. This is the 
factory default. 


Attempting to arm the terminal for Block mode when it 
is already in Block mode will cause communications 
difficulties with the host computer. 


The following command causes the terminal to enter 
Block mode: 


BLOCKMODE yes ‘nr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BMASTERCHARS 


Sets the master characters for Block mode. 
(Memory) 


(Option 01) 


BMASTERCHARS xmt, rec 


xmt is a single character the transmit ‘‘master 
character” for block mode. If you do not enter a 
value for “xmt” it is set to null. Any ASCII 

character is valid; the factory default is the pound 
sign (#). | 


rev is a single character representing the receive 
“master character” for Block mode. If you do not 
enter a value for “rcv” it is set to null. Any ASCII 
character is valid; the factory default is the pound 
sign (#). 


This command cannot be used if the terminal is already 
armed for Biock mode. See the BLOCKMODE com- 
mand. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to null. 


The following command sets the transmit master 
character to an asterisk (*) and the receive master 
characer to a dollar sign ($): 


BMASTERCHARS * $ Sr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BNONXMTCHARS 


Sets the non-transmittable characters for Block mode. 
(Memory) 


(Option 01) 


BNONXMTCHARS °xmt®., revi 


D. is the delimiter character, which must precede 

and follow each parameter. The first character 

after the command word that is not a comma, 

space, or edit character (see EDITCHARS) is the 
delimiter character for this command. | 


xmt is a string of up to 20 ASCII characters 
representing the non-transmittable characters in 
Block mode. The factory default string is the 
pound sign, dollar sign and ampersand (‘#$&’). 


rev is a string of up to 20 ASCII characters 
| representing the non-receivable characters in | 
Block mode. The factory default string is the 


| pound sign, dollar sign, and ampersand (‘#$&’). | 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE com- 
mand. 


If you enter just the command word with no string for 
either “xmt” or “rcv,” both are set to null. 


A character is to be “non-transmitiable” because it has 
a special meaning to the terminal (such as the block 
continue, block end, or block master characters) or 
host. 


The following command sets the plus sign (+ ) and per 
cent sign (%) as non-transmittable characters for both 
transmitting and receiving: 


BNONXMTCHARS '+& '+&' Snr 


These characters may be set by an applications 
program on the host computer or by an initialization file 
on a flexible disk. If it is not, you may need to consult 
with a system programmer for your host computer 


‘before using this command. 
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BPACKING 


Sets the transmitting and receiving packing values for 
Block mode. 
(Memory) 


(Option 01) 


BPACKING xmt, xmtpack, rcv, rcvpack 


xmt must be set to either 7 or 8 bits. It specifies 


the size of each byte that is transmitted. The 
factory default is 7 bits. 


xmtpack must be set to 6, 7, or 8. It specifies the 
number of effective data bits per word that is 
transmitted. The factory default is 6. 


rev must be set to either 7 or 8. It specifies the 
size of each byte received from the host. The 
factory default is 7. 


rcvpack must be set to 6, 7, or 8. It specifies the 
number of effective data bits per word that is 
received. The factory default is 6. 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE 
command. 


The following command sets the “xmt” value to 8, the 
“xmtpack” value to 7, the “rcv” value to 8, and the 
“rcovpack” value to 7: 


BPACKING 8 7 8 7 Sn 


These parameters may be set by an applications 
program on the host computer or by an initialization file 
ona flexible disk (see Section 3). If it is not, you may 
need to consult with a system programmer for your 
host computer before using this command. 
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BREAKTIME 


Specifies the length of the break transmission. 
(Memory) 


BREAKTIME ms 


ms is an integer parameter specifying the length 
of the interrupt, in milliseconds. The valid range is 
from 0 to 65535. The factory default is 200 ms. 


Setting ‘‘ms” to O means that no break transmis- 
sion is sent. If you do not enter any value for the 
parameter, it is set to zero. 


When you press the BREAK key, an interrupt is sent by 
the terminal to the host. The purpose of the interupt is 
to halt execution of a host resident program or 
transmission of data from the host. 


Different host computers must receive an interrupt for 
different amounts of time to recognize it and break off 
the transmission. The length of the interrupt is deter- 
mined by the BREAKTIME command. 


The following command sets the interrupt time to 400 
ms. 


BREAKTIME 400 ‘Cr 


Since the interrupt is handled differently by different 
hosts, you should check with a system programmer for 
your host before using the BREAKTIME command or 
the BREAK key. 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk (see Section 3). If it is not, you may need 
to consult with a system programmer for your host 
computer before using this command. 
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BTIMEOUT 


Determines how long the terminal will wait for a 
response from the host before retransmitting the 
previous block. 

(Memory) 


(Option 01) 


BTIMEOUT seconds 


seconds is an integer parameter specifying the 
number of seconds the terminal will wait before it | 
retransmits a block of data. Valid values are from 

0 to 65535; a setting of O disables the feature. lf 

you do not enter a value for the parameter, it is 

set to zero. The factor default is zero. 


If the setting is too long, you would have to wait a long 
time to become aware that there was a problem such 
as a block being lost. If it is too short, the terminal 
might try to send a block again just because the host 
was slow to respond. Setting it to zero disables the 
timeout feature. 


The following command sets the “time out” to 2 
seconds: 


BTIMEOUT 2 Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BYPASSCANCEL 


Specifies the bypass cancei character. 
(Memory) 


BYPASSCANCEL char 


char is an un-delimited single ASCI! character. 

This parameter is usually set to either a Le (line 

feed) or ar (carriage return). The factory default 
is the ‘r. if no character is specified the parame- 

| ter is set to null and the bypass feature is turned | 
off. 


Remote echo computers use Bypass mode to suppress 
the echoing of unnecessary control characters. The 
terminal uses the bypass cancel character to get out of 
Bypass mode. 


The following command sets the bypass cancel 
character to carriage return. The “tilda” above the first 
carriage return indicates that the carriage return was 
preceded by the literal character (see EDITCHARS). 


BYPASSCANCEL ©r Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk (see Section 3). If it is not, you may need 
to consult with a system programmer for your host 
computer before using this command. 
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COPY 

Copies data from one device to another. 

COPY {source} to {destination} 
{filename} {filename} 


{(destination-filename} 


{source-filename} 


source is a device identifier indicating the loca- 
tion of the file to be copied. If no device is 
specified, the terminal defaults to disk drive 0 
(FO:). Valid devices are: 


HO: host computer 
PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 
FO: disk drive 0 
: disk drive 1 


filename is an un-delimited character string. On 
the “source” side of the command (before the 
word “‘to”), it identifies the name of the file to be 
copied. On the “destination” side of the command 
(after the word “‘to”), it identifies the name of the 
file into which the copy is to be made. Only use a 
filename when the file (either source or destina- 
tion) is on a disk drive. 


source-filename identifies the specific file on the 
disk which is to be copied. The source device 
must be a disk drive. Valid sources are: 


to is a keyword parameter which helps you 
remember the flow flow of the copy — from the 
source to the destination. 


destination is a device identifier indicating the 
location to which a copy is to be made. The 
terminal defaults to disk drive O (FO:) if no device 
is specified. Valid device indentifiers are the 
same as for “source.” 


destination-filename identifies the specific file 
to which the copy is to be made. The destination 
device must be a disk drive. Valid destinations 

are the same as for “source filename.” 


. The copy operation continues until: 
®@ an “end of file” string (EOF) is encountered 
@ you press the CANCEL key 
@ an error is detected 
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An error can be caused by many factors. For example, 
if the destination device is a disk drive an error can 
occur if: 


@ there is no disk in the destination drive 
@ the disk in the destination drive is write protected 


@ the destination drive is trying to write onto a bad 
disk area 


® there isn’t enough room on the destination disk to 
hold the entire output file: 


If a COPY is invoked in Setup mode and you enter 
anything from the terminal’s keyboard during the copy, 
the first 130 characters are queued and executed 
when the COPY is finished. After you enter 130 
characters, the bell rings each time you press any key 
(except CANCEL). 


Before you copy a file to a disk you should make sure 
that there is enough room for the file. You can 
determine the length of an individual file as well as the 
room available on the destination disk with the DIREC- 
TORY command. 


You cannot copy to a file or disk that is write protected. 
A disk can be write protected by the WRITE PROTECT 
switch (see Section 2) or by uncovering the notch in 
the disk (see Section 3). A file or disk can be write 
protected by the PROTECT setup command (described 
later in this section). 


If there is already a file on the destination disk by the 
name you specify and it is not write protected, the 
existing file will be replaced. If the existing file is write 
protected, the copy fails and an error message is 
displayed. 


The following command copies all data from disk 0 to 
disk 1: 


COPY FO: to Ft: Sp 


This command copies “stuff” from the disk in F1: to the 
output device attached to peripheral port 2: 

COPY Ft:stuff to P2: Cr 

And this command copies “‘data1" on disk drive 0 to 
“data2” on disk drive 0: 

COPY datai to data2 
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Copying To and From the Host 


If the source device is the host (HO:), you must begin 
the data transmission before you enter the COPY 
command from Setup mode. Once you enter the 
command, the terminal will wait for a data stream from 
the host until an end-of-file string comes from the host 
or until the CANCEL key is pressed. 


One way to arrange the data stream is: 


® Type the command to the host to begin the data 
stream without the end-of-command character from 
outside of Setup mode. 


® Enter Setup mode. 


@ Type in the COPY command with the desired 
destination. 


Exit Setup mode {after you press the SET UP key, 
the light in the key stays on, but data is being 
transmitted to the host). 


@ Type the end-of-command character. If your host 
echos the character typed on the terminal, the above 
results in the end-of-command character being the 
first character in the data stream. 


Another way to do so is: 


@ Program the host so that there is a delay between 
the time you enter the end-of-command character 
for the host-data-send command and the time the 
data stream begins to flow. If you use this method 
you should give yourself enough delay-time to enter 
Setup mode and type the COPY command with the 
desired destination. You may also want to use the 
QUEUESIZE command to create a large input queue. 


lf you specify the host as destination, then be sure that 
the host is ready to accept data, or you may lose your 
data and/or cause problems with the host. 
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CRLF 


Specifies whether or not a carriage return character is 
interpreted as a carriage return or a carriage return- 
line feed. 


(Memory) 
CRLF {yes} 
{no} 


| yes is a keyword indicating that the terminal 
should attach a line feed character to each 
carriage return character. 


no is a keyword indicating that the terminal 
should not attach a line feed character to the 


carriage return. This is the factory default. 


A carriage return moves the cursor back to the left 
margin of the current line; a line feed moves the cursor 
down one line from its current position. 


The following command causes the terminal to attach 
the tine feed character io the carriage return: 


CRLF yes °r 


If you set the parameter to “yes” and the host 
automatically sends a line feed character with the 
carriage return, the terminal “double spaces” each time 
you press the RETURN key because it is getting a line 
feed from the host and from the terminal. 


If the terminal is in Local mode, pressing the RETURN 
key only returns the cursor to the left margin of the 
current line. You must press the LINE FEED key to 
move to the next line or set CRLF to “yes” so that the 
RETURN key echoes a carriage return line feed 
combination. 


When the terminal is in Setup mode, pressing the 
RETURN key always gives the carriage return-line feed 
combination regardiess of the CRLF specification. 
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DABUFFER 


Specifies the total size of the dialog buffer. 
(Memory) 


DABUFFER lines 


lines is an integer parameter which specifies the 
size of the dialog buffer. The minimum dialog 


buffer size is two; the factory default is 15. 


A change in the dialog’s buffer size becomes effective 
the next time the dialog area becomes visible. 


The maximum dialog buffer depends on the amount o 
available memory. If you specify a dialog buffer larger 
than the currently available memory, it is set to the 
maximum currently available memory. If more memory 
becomes available later, the size of the dialog buffer is 
increased accordingly. 


lf the buffer is full when a line of text is received, the 
first line is deleted to make room for a new line at the 
end. 


The following command increases the dialog buffer so 
it will hold 30 lines of data: 


DABUFFER 30 ‘nr 


If you change the size of the scroll buffer, the 
information in the dialog area is not lost or changed, 
unless the size is reduced. In that case, the most 
recent dialog is maintained in the buffer. The new size 
takes affect the next time the dialog area becomes 
visible. 
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DACHARS 


Specifies the maximum number of characters per line 
in the dialog buffer. 


DACHARS width 


width is an integer parameter indicating the 
maximum number of characters per line. The 


factory default is 73. The minimum width allowed 
is 5; the maximum number of characters allowed 
per line depends on the current character size. 


If you specify more characters per line than can be 
dispiayed, the terminai seis the width io the maximum 
number the current text size allows. The following 
“warning” is displayed the next time the dialog area 
becomes visible (you will not see the warning if the 
terminal’s error reporting mechanism is set to suppress 
warnings): 


>> Terminal Issues Message LV@3: 
>> Dialog Parameters Modified. 


The terminal remembers the width you specified and if 
the text size or dialog area position is changed, the 
width parameter is automatically changed accordingly. 


if you change the width, information in the dialog area 
is not lost. The new width takes effect the next time the 
dialog area is visible, and when the next text is 
received in the dialog area. 


The following command changes the maximum width of 
each line in the dialog area to 35: 


DACHARS 35 Cr 
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DAENABLE 


Enables or disables the dialog area. 
(Memory) 


DAENABLE {yes} 
{no] 


yes is a keyword parameter which enables the 
dialog area. If you do not specify “yes” or “no,” 
| the parameter is set to “yes.” 


no is a keyword parameter which disabies the | 
dialog area. This is the factory default. 


When the dialog area is enabled, all alpha {non 
graphics) text is directed to it. The dialog area itself is 
made visible by a separate command (see the DIALOG 
key in Section 2 and the DAVIS command in this 
section). If the dialog area is enabled when you turn the 
terminal on, the dialog area will automatically be 
visible. 


When the dialog area is not enabled, alpha text is 
directed to the graphics area of the screen. If the dialog 
area is visible but not enabled, you can see text written 
in the dialog area before it was disabled but the 
subsequent text will not go into the dialog area. 


When the dialog area is enabled, pressing the RETURN 
key does not cause the terminal to exit from Vector, 
Marker, or 4010-style GIN mode. If you are in one of 
those modes at the end of a program, press the 
CANCEL key to return the terminal to Alpha mode. 


The following command enables the dialog area: 
DAENABLE ‘a 
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DALINES 


Specifies the number of iines of the diaiog buffer 
displayed on the screen. 
(Memory) 


DALINES 


lines 


lines is an integer parameter, specifying the 

number of lines in the dialog buffer which are to 

be visible. The factory defauit is five. The valid 

range is from 2 to the maximum number allowed | 


| for the current text size. | 


if you specify more visible lines than the current text 
size allows, it is automatically set to the maximum the 
current text size does allow. In that case the following 
warning is displayed the next time the dialog area 
becomes visible (you wiii not see this warning if the 
terminal’s error reporting mechanism is set to suppress 
warnings): 


>> Terminal Issues Message LV@3: 
>> Dialog Parameters Modified. 


If you change the number of visible lines, the 
information in the dialog buffer is not changed or lost. 
The change is effective the next time the dialog area is 
made visible (see DAVIS). 


The following command causes 15 lines of the dialog 
buffer to be displayed at a time: 


DALINES 15 Cr 


6-19 


SET UP COMMANDS 


DAMODE 


Specifies the manner in which characters in the dialog 
area are replaced. 
(Memory) 


DAMODE 


{replace} 
{overwrite} 


replace is a keyword meaning that the character 
is erased as you backspace over it. This is the 
factory default. 


overstrike is a keyword meaning that the charac- 


! 
Text in the graphics area is always overwritten instead 
of being replaced, regardless of the setting of this 
command. 


If you change the setting of DAMODE, it is effective the 
next time the dialog area becomes visible. 


The following command changes the DAMODE setting 
to overstrike: 


DAMODE overstrike nr 


val 
4095,4095 


Figure 6-5. DAPOSITION Extents. 
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DAPOSITION 


Specifies the location of the lower left corner of the 
dialog area. 
(Memory) 


DAPOSITION x, y 


x is an integer parameter specifying the X-axis 
coordinate of the lower left corner of the dialog 
area. 


y is an integer parameter specifying the the Y- 
axis coordinate of the lower left corner of the 
dialog area. 


Figure 6-5 illustrates the limits of the screen coordi- 
nate system for this command. 


The terminal will not allow you to position the dialog 
area off the screen. An error results if you enter “x” or 
“y” coordinates greater than the extents shown in 
Figure 6-5. The position is automatically adjusted if the 
current DACHARS and DALINES settings would not fit 
in the specified position. The terminal remembers the 
Specified location and if the line width or number of 
visible lines is changed, the location of the dialog area 
is automatically changed appropriately. 


If the dialog area position is modified, the following 
warning is displayed the next time the dialog area 
becomes visible (you will not see the warning if the 
terminal’s error reporting mechanism is set to suppress 
warnings): 


>> Terminal Issues Message LV@3: 
>> Dialog Parameters Modified. 


If you change the position of the dialog area informa- 
tion already in the dialog area is not lost. It appears at 
its new position the next time the dialog area is made 
visible (see DAVIS). 


The following command moves the tower left corner of 
the dialog area to the center of the screen: 
DAPOSITION 2049, 1561 Cr 

Whenever the DAPOSITION is changed, the following 


“warning” is displayed the next time the the dialog area 
becomes visible: 


You will not see this message if the terminal's error 
reporting mechanism is set so it will not display 
warnings (see ERRORLEVEL). 


4114 OPERATOR'S 


DAVIS 


Specifies whether or not the dialog area is visible. 


DAVIS § {yes} 


{no} 


yes is a keyword specifying that the dialog area 
should be visible. This is the power up and reset 
default if the dialog area is enabled. If you do not 
enter “yes” or “no,” the terminal defaults to “yes.” 


no is a keyword specifying that the diaiog area 
should not be visible. This is the power up and 
reset default if the dialog area is not enabled. 


Entering this command has the same effect as pressing 
the DIALOG key. When you use DAVIS to make the 
dialog area visible, the light in the DIALOG key turns 
on. The light turns off when you use DAVIS to make the 
dialog area not visible. 


If the dialog area is enabled when the terminal is 
turned on, the dialog area is automatically visible. 


When you enter the command, it takes effect 
immediately. 


You can use the DAVIS command to update the dialog 
area if you change any of its attributes. For example, if 
you change the dialog area’s position and the number 
of visible lines, you can enter the following command to 
make the changes effective: 


DAVIS Cr 
Even though the dialog area may already be visible, 


this command updates it as though the dialog area 
were turned off and back on again. 
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DEFINE 


Defines a macro and associates it with a key or an 
integer. 


DEFINE key] 


fall] 


DEFINE key, °Lmacro®. 


DEFINE key, ".macro [ “Ke macro *e] 


| key specifies the key or integer with which this | 


macro is to be associated. If the command is 
terminated after this parameter, the macro asso- 
ciated with the specified key or integer is deleted. 


all is a keyword indicating that all existing 
macros should be deleted. 


DP. is the delimiter character. You can use any 
ASCH}! character to delimit the macro except: 


| a comma. 
a space 
the “character deiete” character (see 
EDITCHARS) 
the “line delete” character (see EDITCHARS) 
the “literal” character (see EDITCHARS) 


The first character after the “key” parameter that 
is not a space, comma, or edit character is the 
delimiter for that macro. The delimiter should not 
occur in the macro itself, since the second use of 
the delimiter terminates the macro. The same 
delimiter must be used to terminate the macro. 


| macro is the character or character string trans- 

mitted when you press the specified key or when 
the host executes the integer associated with the 
macro. The total length of the command (includ- 
ing the command word and macro) can be a 
maximum of 130 characters. If you want to 
include a “carriage return” or one of the edit 
characters in a macro, it must be preceded by the 
“literal” character — see the EDITCHARS 
command. 


Ke is the “key execute delimiter’ character. When 
this character appears in a macro, it changes the 
direction of the macro expansion. If it was being 
expanded to the host, the key execute delimiter 
causes it instead to be expanded to the terminal; 

if the terminal had been receiving the macro it is 
subsequently sent to the host. The expansion of a 
subsequent macro starts in the same direction as 
when the last macro ended. The “key execute 
delimiter” is defined by the KEYEXCHAR command. 
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Specifying a Key or Integer 


Indicate an alphanumeric key you want to associate 
with a macro by pressing the key or by entering its ADE 
value. 


For example, the following commands both assign a 
macro to the upper case A character. After this 
command, whenever you press the upper case A 
character “a macro or string’ would be transmitted. 


DEFINE A /amacroorstring/ Cr 
DEFINE 65 /amacroorstring/ p6°R 
Each function key can be identified by a mnemonic 
abbreviation or by an integer as in Table 6-3. 
Table 6-3 
FUNCTION KEY IDENTIFIERS 


Mnemonic 


F1 function key 1 
F2 function key 2 
F3 function key 3 
F4 function key 4 
F5 function key 5 
F6 function key 6 
F7 function key 7 
F8 function key 9 
$1 shifted function key 1 
$2 shifted function key 2 
$3 shifted function key 3 
$4 shifted function key 4 
$5 shifted function key 5 
s6 shifted function key 6 
$7 shifted function key 7 


shifted function key 8 


The following commands show the two ways to assign 
“a macro or string” to function key 1. 


DEFINE F1 /amacroorstring/ Cr 
DEFINE 128 /amacroorstring/ Cr 


Associating a Macro with an Integer 


You can assign an integer value for the “key” to cause 
the macro to be associated with the specified integer. 
The valid range of integers is 144 to 34767. A macro 
associated with an integer can only be executed by a 
command from the host (or by using a special form of 
commands called “escape sequences”). 


The following command shows how to associate “a 
macro or string” with the integer 1000. An actual macro 
would be accessed by the host issuing a command to 
the terminal: 


DEFINE 1000 /amacroorstring/ Sr 
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Carriage Return and Edit Characters 


Since the carrige return control character is executed 
in Setup mode when you press the RETURN key, it 
must be treated specially to be part of a macro. The 
same is true for the keys reserved as edit characters 
(see EDITCHARS). 


The third character defined by EDITCHARS is the 
“literal” character. To include a carriage return or edit 
character in a macro, precede it with the literal 
character. 


The factory default literai character is the tilda (~}. In 
the following example, the tilda key is pressed before 
the RETURN key, causing the rn to be displayed as a 
snoopy character (instead of being executed) and a 
carriage return becomes part of the macro. (The tilda is 
shown above the °r because the character entered 
after the literal character replaces it.) 


If you enter a return before the literal character, the 
carriage return is processed and an error message is 
displayed because you impropery terminated the DE- 
FINE command. If you press the “character delete” 
before the tilda, the terminal backspaces and deletes 
the last character entered. If you press the line edit key 
before you press the literal key, the current line is 
deleted. 


Using the Key Execute Delimiter 


When a macro is expanded by pressing the key, every 
time the terminal encounters the key execute delimiter 
it reverses the direction of the macro expansion. (When 
a macro is expanded by the “expand” command from 
the host or from the terminal in the escape sequence 
format, the key execute delimiter character is ignored.) 


In the following example, the macro starts by being 
expanded to the host. When it encounters the key 
execute toggle delimiter, it changes direction and is 
expanded to the terminal. The second key execute 
delimiter directs the flow back to the host again. 


DEFINE 128 /FORT GRAF Cr *e -cSO1 
Ke EX GRAF Cnr/ Cn 


The initial direction of a macro depends on how it was 
set in the last macro that was expanded. In the 
previous example, the second key execute toggle 
character returns the flow toward the host. If it had not 
been included, the next macro would have been 
expanded by the terminal until another key execute 
toggle character was entered. 
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DELETE 


Deletes the specified file. 


(Options 42/43) 


DELETE (filename} 
{device-filename} 


filename is an un-delimited character string 
identifying the name of the file to be deleted. If no 
device is specified, the terminal defaults to disk 
drive O (FO:). 


device-filename identifies the specific devic 
and file on the disk in that device which is to be 
deleted. Valid device specifications are: 


FO: disk drive 0 
F1: disk drive 1 


An error results if the disk is write protected (by the 
WRITE PROTECT switch or the write protect notch in 
the disk) or if the file you try to delete is write protected 
by the PROTECT setup command. 


The foliowing command wouid deieie the file named 
“info” from the disk in disk drive 0: 


DELETE F1:info 
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DIRECTORY 


Dispiays or copies the fiie directory of the specified 
disk. 


(Options 42/43) 


DIRECTORY [source] to [destination] 
[source-filename] [destination- 
filename] 


if no parameter is specified, the directory of the 


disk in drive 0 (FO:) is displayed. 


source identifies the location of the disk for 
which a directory is to be displayed or copied. 
The terminal defaults to disk drive 0 if the source 
is not indicated. Valid sources are: 


FO: disk drive O 
F1: disk drive 1 


filename identifies the specific file on the disk for 
which a directory is to be displayed. 


source-filename specifies the disk and file for 
which a directory is to be displayed or copied. 


being copied — it is copied from the source to 
the destination. ; 


directory is to be copied. The “source” and 
“destination” can be the disk in the same drive. If 
no device name is specified, the terminal defaults 


to heips identify the direction if the directory is 
to the screen. Valid device names are: 


none the screen 

HO: the host port 

PO: peripheral port 0 

P1: peripheral port 1 

P2: peripheral port 2 

FO: disk drive 1 (requires a filename) 
F1: disk drive 2 (requires a filename) 


1 
destination indicates the location to whicha 


destination-filename indicates the specific file 
to which a directory is to be copied. If no device is 
specified, the terminal defaults to disk drive 0. 


(continued): 
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The following command causes the directory of a file 
named “stuff” to be displayed on the screen 
(Figure 6-6). 


DIRECTORY FO:stuff Sr 


The directory entry for each file includes the file’s 
name, size in blocks, the number of bytes in its last 
block, and whether or not it is write protected. 


The following command displays the directory for the 
entire disk in drive O (Figure 6-7). 


DIRECTORY Cr 


If you specify the host as destination for the directory, 
then be sure that the nost is ready to accept data. if 
you do not, you may lose your data stream causing 
communications problems with the host. 


*DIRECTORY F1:STUFF 
~NAME BLOCKS BYTES PROTECT 
F1:GRAPHS 2002 


NO 
STUFF 218 NO 
-ENTRIES USED: 


-ENTRIES FREE: 
-BLOCKS USED: 
~BLOCKS FREE: 1955 
-LARGEST FREE: 1955 
* 


Figure 6-6. The Directory of a File. 


*DIRECTORY F1: 
—~NAME BLOCKS BYTES PROTECT 
2882 NO 


~ENTRIES USED: 
“ENTRIES FREE: 
-BL.OCKS USED: 
~BLOCKS FREE: 
-LARGEST FREE: 
x 
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DUPLEX 


Specifies what kind of duplex mode the terminal is in. 
(Memory) 


(Option 01) 

DUPLEX (full} 
{normal} 
{auto} 
{super} 


full specifies that the terminal is in full duplex. 
This is the factory default communications mode 
for a terminal with Option 01 installed. If you 
enter the command word and no parameters. the 
terminal defaults to “full.” 


normal specifies that the terminal is to be in “Half 
Duplex Normal” mode. 


auto puts the terminal into “Half Duplex with 
Automatic Request to Send” mode. 


super puts the terminal into “Half Duplex with 
Supervisor” mode. 


Section 5 in this manual provides a very brief overview 
of the terminal’s communications modes. See the 4114 
Host Programmer’s Manual for information. 
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ECHO 


Specifies whether or not the terminal provides an 
“echo” of characters typed on the keyboard and sent 
to the host computer. 


ECHO {yes} 
{no} 


yes is a keyword meaning that the terminal will 
provide the echo. If you enter the command word 
but do not specify “yes” or “no,” the terminal 


defaults to “yes.” 


no is a keyword meaning that the terminal will not 
provide the echo. This is the factory default. 


The “echo” is the display of characters on the terminal 
screen as they are typed at the keyboard. 


When ithe terminai is in Setup or Locai modes, the echo 
is provided by the terminal regardless of the status of 
ECHO, 


If the computer you log onto is a remote-echo host, it 
provides the echo for you automatically. If you set the 
terminal to provide the echo, too, each character is 
echoed twice when you are in communications with the 
host — once by the terminal and once by the host. 


If the computer you log onto is not a remote-echo host, 
enter the following command so the terminal will 
provide the echo when you are communicating with the 
host: 


ECHO yes “rR 


4114 OPERATOR'S 


SET UP COMMANDS 


EDITCHARS 


Specifies “delete” characters for Setup mode and a 
“literal” character to precede control characters in 
macros. 


EDITCHARS chardel, linedel, literal 


chardel can be any ASCIl character except the 
“linedel” or “literal” characters. Specify a charac- 
ter by pressing the appropriate key or entering its 
ADE (ASCII Decimal Equivalent) value. The | 
“chardel” character is used in Setup mode to 
backspace along a line to correct a typing error. 

The factory default is RUB OUT (ADE 127). 


ljinedel can be any ASCII character except the 
“chardel”’ or “literal” characters. Specify a char- 
acter by pressing the approriate key or entering 
its ADE value. The “linedel” character is used in 
Setup mode io abort a line without executing it, 
and start a new line. The factory default is 
“cancel” (ADE 24). Type the cancel character 
from the keyboard by pressing the CTRL and X 
keys at the same time. 


literal can be any ASCII character except the | 
“chardel” or “linedel” characters. Specify achar- | 
acter by pressing the appropriate key or entering } 
its ADE value. The factory default literal character 

is the “tilda” (~) (ADE 126). The “literal” must 
precede the following characters if they are 

included in a macro: 


a Carriage return 
the character delete 
the line delete 

the literal character 


The following command specifies the “chardel,” “li- 
nedel,” and “literal” characters as the percent sign (%), 
pound sign (#), and dollar sign ($), respectively. 


EDITCHARS % # $ Sr 


If you are in Setup mode and you need to delete one or 
more characters, press the '%” key to back up along 
that line to correct or change it. Press the “#” key to 
back up to the beginning of the line. 


If the dialog area is not used, the terminal will always 
overwrite characters when you use the “chardel” key 
— it will not replace the characters. If the dialog area is 
not used, the “linedel” key moves down to the next line 
instead of to the beginning of the current tine. 
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Use of the literal character ($ in this example) is 
illustrated with the DEFINE command. 


You don’t have to enter all three parameters if you only 
want to change the first or second edit characters. For 
example, if you only want to change the “character 
delete” character, you could enter the following 
command: 


EDITCHARS & ‘Sr 


That command changes the character delete character 
to & and leaves the line delete and literal characters at 
their current specifications. 


If you specify the same character for all three parame- 
ters, it will be used as the character delete character. 
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EOFSTRING 


Specifies the string which is automatically sent to the 
host by the terminal when it detects an end of file and 
which the terminal uses to end a file being sent to it 
during a SPOOL, COPY, or PCOPY. 

(Memory) 


EOFSTRING string. 


2. is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


string is a delimited combination of up to ten 
ASCII characters. The first character cannot be 
repeated elsewhere in the string. The default is 
the null string. If you enter just the command 
word and no string, the terminal defaults to the 
null string. 


When the terminal is copying a file from the host, it 
terminates the copy when it encounters the end of file 
string. 


The end of file string should be set to whatever the host 
computer actually sends at the end of a file. If you do 
not, you will have to press the CANCEL key to close 
disk files. 


In the following command, the slash (/) is the delimiter 
and the end of file string is set to an ampersand (&). 


EOFSTRING /&/ Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk (see Section 3). If it is not, you may need 
to consult with a system programmer for your host 
computer before using this command. 
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EOLSTRING 
Assigns the end of line string used by the terminal. 


EOLSTRING “:string™ 


D, is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, character (see EDITCHARS) is the delimi- 
ter character for this command. 


string is the character string the ierminai uses to 
signal the end of the transmission of a line of 
data. The factory default is the carriage return. 


The “end of line string” is sent by the terminal at the 
end of (or during) transmissions generated by the 
terminal. 


When a host program requests information from the 
terminal, it may be sent automatically, not requiring 
operator interaction. For example, the program may 
request a report of error messages or some graphics 
input data. In such cases, the terminal sends an end of 
line character to the host to indicate the end of a 
transmission. 


The following command changes the end of line string 
to the +r (line feed): 


EOLSTRING "r’ Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization fileona 
flexible disk. If it is not, you may need to consuit with a 
system programmer for your host computer before 
using this command. 
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EOMCHARS 


Specifies the end-of-message (turnaround) characters. 
(Memory) 


EOMCHARS [char1] 
[char1, char2] 


char1 and char2 are un-delimited ASCII charac- 
ters. If you specify just one character, the second 
character is set to nuil. If you do not specify 


either character, both are set to null and no end of 
message checking is done at all. The default end 
of message characters are ©r (carriage return) 
and §i (null). 


if the terminal is in Prompt mode, Block mode or Half 
Duplex mode, it stops transmitting when it encounters 
either “end of message” character. (See the PROMPT- 
MODE, BLOCKMODE, and DUPLEX commands). 


in Prompt mode, for example, when an end-of-message 
character is transmitted the terminal terminates 
transmission until it receives a prompt. 


The following command would set the end of message 
characters to ‘+ (line feed) and &c (escape). 


EOMCHARS 'r fc Sr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. | 


6-27 


SET UP COMMANDS 


ERRORLEVEL 


Specifies how severe an error must be before it is 
displayed by the terminal. 


ERRORLEVEL {0} 


0 specifies that all messages, warnings, errors, 
and terminal failure messages should be dis- 
played. If you enter just the command word and 
no parameter, the error level is set to 0. 


1 specifies that warnings, errors and terminal 
failure messages should be displayed. 


2 specifies that errors and terminal failure 
messages should be displayed. This is the de- 
fault. 


3 specifies that only terminal failure messages 
should be displayed. 


4 suppresses all messages, warnings, errors, and 
terminal failure messages. 


The ERRORLEVEL command does not affect error 
messages that are generated by host resident software 
programs or the host computer. 


The terminal's error messages are stored in an error 
queue whether or not they are displayed. The applica- 
tion program can examine that queue for an error 
report. 


The following command would set the terminal so that 
only terminal failure messages are displayed: 
ERRORLEVEL 3 “rp 


Appendix A lists the terminal’s warnings, error 
messages and terminal failure messages. 


6-28 REV AUG 1981 


FLAGGING 


Specifies whether or not the terminal is to use flagging, 
and if so, what kind of flagging. 


(Memory) 

FLAGGING {none} 
{input} 
{output} 
{inout} 
{dtr} 


none is a keyword indicating that flagging is not 
to be done. This is the factory default. 


input is a keyword indicating that when the 
terminal’s input buffer is full, it sends a DC3 
character character to stop the host; the terminal 
sends a DC1 character when it is ready to receive 
data again 


output is a keyword indicating that the DC1 and 
DC3 characters are used for flagging. 


inout is a keyword indicating that the terminal 
and host both use the DC1 and DC3 characters to 
flag each other as to when to start and halt 
communications. 


dtr is a keyword indicating that when the termi- 
nal’s input queue is nearly full it lowers the DTR 
(DATA TERMINAL READY) line on the RS-232 
connector; when the terminal's input queue is 
ready for more data, the terminal raises the line. 


For output, when the host lowers the CTS (CLEAR 
TO SEND) line, the terminal stops sending data; 
the terminal resumes transmission when CTS 
goes high again. 


Flagging allows the terminal and host computer to 
indicate to each other when they are ready to send or 
receive data. This prevents their input buffers from 
overflowing, which would cause data to be lost. 


The following command would cause the terminal to 
use input flagging: 


FLAGGING input Cr 


Whether or not the terminal should use flagging, and 
what kind of flagging mechanism it does use depends 
on your host computer. 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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FORMAT 
Formats a flexible disk so it can be used to store data. 


FORMAT [device] diskname [files] 


(Options 42/43) 


device indicates the disk drive containing the 
disk to be formatted. If a disk name is given but 


no device is specified, the terminal defaults to 
disk drive O (FQ:). Valid device indicators are: 


FO: disk drive 0 


Fi: disk drive 1 


diskname is an un-delimited string of up to nine 
alphanumeric characters identifying the disk; a 
Space cannot be included in the “diskname.” If no 
“diskname” is given but a device is specified, no 
“diskname” is assigned. 


| files is an integer specifying the maximum num- 
| ber of files that can be created on the disk. The 
default is 368; the valid range is 368 to 1872. 


A disk must be formatted before it can be used. If you 
format a disk which already has files on it, the files are 
inaccessible. 


If you specify a number less than 368, the disk is 
formatted for 368 directory entries. If you specify a 
number greater than 1872 the disk is formatted for 
1872. if the number you specify is not divisible by 16, it 
is rounded up to the nearest multiple of 16. 


A disk cannot be formatted if it is write protected by the 
WRITE PROTECT switch (see Section 2) or when the 
write protect notch in the disk is not covered (see 
Section 3). 


The following command formats the disk in drive O for 
384 files and names the disk SALESDATA. 


FORMAT SALESDATA 384 ‘na 


This command formats the disk in drive 1 for 1000 
files, and names it NUMBERS: 


FORMAT F1:NUMBERS 1000 Cr 


CAUTION 


Do not open the door to the disk drive while the 
disk is being formatted. If you do, you must close 
the door, press the RESET button to reset the 
terminal, and then reformat the disk. 
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GRIDDING 


Establishes a grid on the terminal's screen for use in 
graphics input (GIN) mode. 


GRIDDING device-function, [xgrid, ygrid] 


device-function indicates the graphics input 
device used and what function is being performed 
by the input device. Valid specifications are: 


QO thumbwheels for locator function 

i thumbwheeis for pick function 

8 tablet for locator function 

9 tablet for pick function 
24 port O for locator function 
25 port O for pick function | 
32 port 1 for locator function | 
3 port 1 for pick function 
| 40 port 2 for locator function | 
| 41 port 2 for pick function | 

j 

| | 


xgrid specifies the distance between the grid 
lines parallel to the x-axis. The default when the 
terminal is turned on is zero; if you do not enter a 
value for “xgrid” it is set to zero. The valid range 
is from 0 to 4095. 


ygrid specifies the distance between the grid 
lines parallel to the y-axis. The default when the 
terminal is turned on is zero; if you do not enter a 
value for “ygrid” it is set to zero. The valid range 
is from O to 4095. 


Gridding is usually set by a host program when it puts 
the terminal into graphics input (GIN) mode. It can help 
you draw lines or locate a point more precisely. 


The following command sets up a 100 x 100 grid for 
the terminal's thumbwheels for the locator function: 


GRIDDING 0 100 100 Sr 
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IGNOREDEL 


Specifies whether or not the terminal ignores the delete 
(RUBOUT) character. 
(Memory) 


_IGNOREDEL yes} 


{no} 


yes is a keyword indicating that the delete 


character should be ignored. 


no is a keyword indicating that the delete charac- 
ter should not be ignored; this is the factory 


default 
| ua i he j 
You should only set this parameter to “yes” if your 


program uses £c < ?> as a substitute for the OL in 
graphics. 


The following command changes the setting of 
IGNOREDEL to “yes”: 


IGNOREDEL Sr 
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KEYEXCHAR 


Specifies the “key execute delimiter” character. 
(Memory) 


KEYEXCHAR char 


char specifies the “key execute delimiter.” Any 
ASCII character can be used, but it is best to 


choose one that is not used in a typical text 
string. The factory default is °« (CTRL-P). 


The “key execute delimiter” determines whether a 
macro is expanded by the terminal or the host. When a 
macro is being expanded by the host and the terminal 
encounters the key execute delimiter, the direction is 
reversed so the terminal is executing the macro. When 
it encounters another key execute delimiter, it causes 
the host to begin to expand the macro again. 


If the terminal is in Local or Setup mode, all macros are 
expanded locally and the key execute delimiter is 
ignored. 


The following command would define n as the key 
execute delimiter: 


KEYEXCHAR 24 Cr 


For an example of the use of the key execute delimiter, 
see the DEFINE command earlier in this section. 
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LFCR 


Specifies whether the line feed character is interpreted 
as a line feed or a line feed-carriage return. 
(Memory) 


LFCR {yes} 
{no} 


yes is a keyword indicating that the terminal 
should attach a carriage return character to each 
Le (line feed). 


no is a keyword indicating that the terminal 
should not attach a carriage return character to 
each | (line feed). 


A carriage return causes the cursor to move to the left 
margin of the current line; a line feed moves the cursor 
down one line from its current position. A carriage 
return-line feed combination moves the cursor to the 
left margin of the next line. 


The following command would cause the terminal to 
attach the carriage return character to the line feed: 
LFCR Sr 

When the terminal is in Local mode, it is necessary to 
change the parameter to “yes” if you want to get the 


carriage return-line feed combination by pressing just 
the LINE FEED key. 
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LOAD (Options 42/43) 


Reads a file and executes it as a command file. 


LOAD [filename] 
[source-filename] 


source-filename specifies the source of the file 


and the name of the specific file to be read. Valid 
sources are: 


HO: host computer port 

PQ: peripheral port O 

P1: peripheral port 1 

P2: peripheral port 2 

FO: disk drive 0 (requires a filename) 
F1: disk drive 1 (requires a filename) 


filename specifies the name of the file to be read. 
If no source is specified, the terminal defaults to 
disk drive O (FO:). 


Pressing the CANCEL key aborts the loading of a file. 
All other input to the terminal is queued until the file is 
loaded or aborted. 


Nesting of LOAD commands is allowed. That is, a file 
being loaded can in turn contain a LOAD command. 
That file can also contain a LOAD command, and so on. 
The limitation of nesting varies, depending on how busy 
the terminal is with other tasks. 


The following command loads the file coming to ihe 
terminal from peripheral port 1: 

LOAD P1; Cp 

This command loads the file named INITIALIZ in disk 
drive 0: 

LOAD INITIALIZ ‘nr 
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LOCKKEYBOARD 


Locks the terminal’s keyboard. 
LOCKKEYBOARD 


No parameters need to be entered. As soon as you 
enter the carriage return, the keyboard is locked. 


When the keyboard is locked you can still press the 
keys, but the characters are not echoed on the screen. 
The terminal’s bell rings when you press any key 
except the BREAK or CANCEL. 


The keyboard should usually be locked and unlocked 


by ihe appiication program. 


CAUTION 


Pressing the CANCEL key, or the RESET button 
may cause you to lose information on the screen 
or halt other terminal operations in process. Do 
not do so unless you are sure you will not lose 
important data. 


You can unlock the keyboard by pressing the CANCEL 
key, the BREAK key, or the RESET button. 
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Specifies the number of columns into which the screen 
is divided. 
(Memory) 


MARGIN (1, 2, 3, ... 8} 


0-8 indicate the number of columns into which 
the screen is to be divided; the factory default is 


1. A page full condition occurs when the cursor 
reaches the end of the last line of the last column. 


This command only pertains to alpha text displayed in 
than aera nmkia Artian Af thn nmavanan It alan nant annhu ta 


ine Grapnics poriign Gi wie SCTSEN. it GOES T1Gi appry io 


graphics text or to text in the dialog area. 


The following command causes the screen to be 
divided into six columns. Lines between the columns 
are not visible. They are shown in Figure 6-8 to 
illustrate the size of the columns. 


MARGIN 6 ‘na 
You can use the ALPHASIZE command to specify the 


correct character size and insert carriage returns 
appropriately so the text will fit in the columns. 


Tektronix 4114 


Figure 6-8. The Result of the MARGIN 6 Command. 
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PAGEFULL 


Specifies action to be taken when the “page full” 
condition occurs. 


(Memory) 

PAGEFULL [none} 
{stop} 
{autocopy} 
Se 


none is a ae eee meaning that no action is 
taken; when the cursor reaches the last line of 
the last column, it returns to the upper left corner 
of the screen and continues, writing over any text 
already there. This is the factory defauit. if you 
enter the command word with no parameter, it is 
set to “none.” 


stop is a keyword meaning that when a page full! 
condition occurs, the terminal stops displaying 
text. incoming text is stored in the input queue 
and displayed when the page full condition is 


cleared. 


autocopy is a keyword meaning that when a page 
full condition occurs, the terminal makes a hard 
copy of the screen, erases the screen, and 
continues. While the hard copy is being made, 
incoming text is stored in the terminal’s input 
queue. 


break is a keyword meaning that when a page full 


condition occurs, the terminal sends an interrupt 
ta tha hnet tn discontinue tha sending at informa- 


RNP REE PRR ON EOE REI OPEN UE Pree 


tion (the equivalent to pressing the BREAK key). 


\f flagging is not being used (see the FLAGGING 
command in this section, the communications overview 
in Section 5, and the 4114 Host Programmer's Manual) 
the input queue may be overrun when you use 
“autocopy” due to the time it takes to make the hard 
copy. If this is the case, you may want to use a flagging 
mechanism or the QUEVESIZE command to be sure 
that the input queue is large enough so that it is not 
overrun. 


The following command sets the terminal so that when 
a page full condition occurs, it makes a hard copy, 
erases the screen, and then continues. 


PAGEFULL autocopy Cr 


4114 OPERATOR'S 


“PARITY 


SET UP COMMANDS 


PARITY 


Specifies the kind of parity used by the terminal for 
checking input and when transmitting to a host. 
(Memory) 


{none} , 

{high} 

{even} 

{odd} 

{data} 

oe oe 5 
none means that the parity bit is set to O for 
transmission of data. 


high means that the parity bit is set to 1 for 

transmission of data. 

even means that the sum of the bits in the byte 
| must be even for output. 


odd means that the sum of the bits in the byte 
must be odd for output. 


data means that all eight bits are used to send 
data for output. 


Parity is a means for verifying the accuracy of com- 
munication between the terminal and a host computer. 
The terminal does not check parity on input, but it can 
be set to transmit data according to the host compu- 
ter’s parity convention. 


The following command sets the terminal to transmit 
odd parity: 


PARITY odd Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexibie disk. if it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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PASSIGN (Option 10) 


Assigns a device driver and/or an identification code to 
the specified port. 
(Memory) 


PASSIGN port, device 


port identifies the port to which a device driver 
and/or an identification code is assigned. Valid 
port specifications are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


device is an integer that identifies the device 
driver is assigned to the specified port. Valid 
device drivers are: 


Device Meaning 


4662 Translates terminal commands into 
4662 commands and 4662 com- 
mands into terminal commands; the 
plotter must be used in Block mode. 


4662/U Does not translate commands 
between the terminal and 4662. 


4662/31 Same as “4662” driver, but in- 
cludes pen changing support added 
by the plotter’s Option 31. 


Translates terminal commands into 
4663 commands and 4663 com- 

mands into terminal commands; the 
plotter must be used in Block mode. 


4663/N Translates terminal commands into 
4663 commands and 4663 com- 
mands into terminal commands; the 
plotter must be used on Continuous 
Communications mode (use 
DC1/DC3 or CTS/DTR flagging). 


4663/U Does not translate commands be- 
tween the terminal and the 4663; 
plotter must be used on Continuous 
Communications mode. 


General purpose; supports any 
Tektronix device with an RS-232 
connector. 


if you attach a device to a port, the device must be 
compatible with the assigned driver. 


The following command assigns the 4663 device driver 
to peripheral port 0: 

PASSIGN PO: 4663 Cr 

This command assigns the general purpose device 
driver to peripheral port 2: 

PASSIGN P2: PPORT nr 
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PBAUD (Option 10) 


Assigns a rate for transmitting and receiving data for 
the specified port. 
(Memory) 


PBAUD port, baudrate 


port indicates which port is receiving a baud rate 
assignment; valid port assignments are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


baudrate is an integer which specifies the rate at 
which data will pass through the assigned port. 
The factory default is 2400. 


The baud rate that you assign to each port must be 
compatible with the baud rate of the device you attach 
to the port. If it is not, there will be communications 
problems. 


Valid baud rates are: 


110 
134(sets baud rate to 134.5) 
150 
300 
600 
1200 
1800 


AAD 
vu 


2400 
3600 
4800 
7200 
9600 


The following command sets the baud rate at 1200 for 
peripheral port 2: 


PBAUD P2: 1200 Cr 
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PBITS (Option 10) 


Specifies the stop bit and data bit convention for the 
indicated peripheral port. 
(Memory) 


PBITS port, stopbits, databits 


port indicates the port for which the stop-bits and 
data bits conventions are specified. Valid ports 
are: 


PQ: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


stopbits is an integer specifying the minimum 
number of bits following the data bytes in the 
communications with the device attached to the 
port. The integers 1 and 2 are valid; the factory 
default is 2. 


databits indicates the length in bits of the data 
bytes used to communicate with the device 
aitached to the port. The integers 5, 6,7, and 8 
(representing 5-bit, 6-bit, 7-bit, and 8-bit bytes) 
are valid. The factory default is 8. 


The standard ASCII character has 7 data bits and one 
parity bit (see PPARITY later in this section, 


Both “‘stopbits” and “databits” for a port must be 
compatible with the device that is attached to that port. 
If they are not, there will be communications problems. 


The foiiowing command sets the data bit size to 7 and 
stop bits to 1 for peripheral port 0: 


PBITS PO: i 7 Sr 
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PCOPY 


Establishes a two-way data path between two devices. 


(Option 10) 


PCOPY source to destination 


source indicates the device which initiates and 
terminates the communication. Valid devices are: 


HO: the host port 

PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


to is a keyword that helps you remember the flow 
of the copy — from the source to the destination. 


destination specifies the device which is origin- 
ally on receiving end of the communication path. 
Valid devices are: 


: the host port 
peripheral port O 
peripheral port 1 
peripheral port 2 


Since the data path is two-way, the two devices can 
carry on communication without involving the terminal. 
it is as if the terminal were not present and the two 
devices were connected directly to each other. 


The connection between the devices is established by 
the PCOPY command. Communications must be start- 
ed by the “source” device. The connection is broken 
when the terminal detects an end-of-file string (see 
PEOF) from the source device, when you press the 
CANCEL key, or if there is an error. 


The Setup mode prompt reappears on the screen when 
the PCOPY is finished. The first 130 characters you 
type during a PCOPY are stored in a queue. They are 
echoed and executed when the PCOPY is finished. 


The following command allows the host and the device 
attached to peripheral port 2 to transfer data without 
involving the terminal: 


PCOPY HO: to P2: Cr 
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If the source device is the host (HO:), then you must 
arrange to begin the data stream before you enter the 
command in Setup mode, because once the command 
is entered the terminal will wait for a data stream from 
the host until an end-of-file comes from the host or the 
CANCEL key is pressed. 


Two ways to start the data stream appropriately are: 


1. Type the command to the host to start the data 
stream without the end-of-command character 
from outside of Setup mode, enter Setup mode, 
type in the PCOPY command with the desired 
destination, exit Setup mode, and type the end-of- 
command character. This should start the data 
stream from the host. !f your host echos the 
characters typed on the terminal this method 
results in the end-of-command character being the 
first character in the data stream. 


2. Program the host so that there is a delay between 
the time you enter the end-of-command character 
for the host-data-send command and the time the 
data stream begins to flow. If you use this method 
you should give yourself enough time to enter 
Setup mode and type the PCOPY command with 
the desired destination. 
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PEOF 


Specifies the string to be sent to the peripheral port 
when an end-of-file is detected by the terminal. 
(Memory) 


(Option 10) 


PEOF port, “. string 


port indicates the port for which the specified 
string denotes end-of-file. Valid ports are: 


PO: peripheral port 0 | 
P1: peripheral port 1 
P2: peripheral port 2 


D._ is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


| string is a delimited string of up to ten ASCIi 
characters. The factory default is the null string. 


The port-EOF string that you assign to a port should be 
the same as the end of file string for the device 
attached to that port. 


in the following command the slash (/) is used as the 
delimiter and the ‘peripheral end of file” string is 
changed to “???7?.” 


PEOF P1:/?772/ Sr 
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PEOL 


Assigns the end-of-line string to be used by the 
specified port. 
(Memory) 


(Option 10) 


PEOL port, % string 


port indicates the port for which the specified 
string denotes end-of-line. Valid ports are: 


PO: peripheral! port 0 
P1: peripheral port 1 
P2: peripheral port 2 


2. is the delimiter character, which must precede 

and follow each parameter. The first character 

after the command word that is not a comma, 

space, or edit character (see EDITCHARS) is the 
| delimiter character for this command. 


string is a delimited string of up to ten ASCil 
characters. The factory default is a carriage 
return. 


The port-EOL string that you assign to a port should be 
the same as the end of file string for the device 
attached to that port. 


In the following command, the end of line string is set 
to be a ' (line feed) for peripheral port 0. 


PEOL PO: ’r’ Sr 
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PFLAG (Option 10) 


Sets the Flagging mode for the specified peripheral 
port. 
(Memory) 


PFLAG port, flag, [gol], [stop] 


port indicates the port for which Flagging mode is 
being defined. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


flag indicates which of the three t 


i) fixe) ' 


is to be assigned. 


NONE 
CHAR = 
DTR a 


no flagging 
character flagging (factory default) 
DTR/CTS (hardware) flagging 


go is a single character parameter which can be 
specified when “character flagging” is used. The 
terminal uses the “go” character to indicate that 
data transmission can proceed. Any ASCII char- 
acter is valid; DC1 (ADE 17) is the factory default. 
If no character is specified, “go” defaults to DC1. 


stop is a character parameter which can be 
specified when “character flagging” is used. The 
terminal uses the “stop” character to indicate 
that data transmission should stop. Any ASCII 
character is valid; DC3 (ADE 19) is the factory 
default. If no character is specified, “stop” 
defaults to DCS. 


The following example specifies that flagging is not 
used at peripheral port 0: 


PFLAG PO: O Cnr 
This command causes peripheral port 1 to use charac- 


ter flagging with “?" as the “go” character and the 
default DC3 as the “stop” character: 


PFLAG Pi: 1. ? Sr 
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PICKAPERTURE 


Specifies the “a” square within which the graphics 
input device can “pick” an object. 


PICKAPERTURE [size] 


size specifies the side of the square within which 
the graphics input device is centered. The default 


when the terminal is turned on or reset is 8. If you 
do not specify a size, the terminal defaults to 0. 


The following command specifies a pick aperture of 4. 
This creates a 4 x 4 square with the graphics input 
locator centered in the square. If you attempt to “pick” 
an object, it must have its X and Y coordinates within 
two units (plus or minus) of the locator device in order 
to be detected. 


PICKAPERTURE 4 Cr 


See the 4114 Host Programmer's Manual and the 4110 
Series Command Reference for details on “picking” 
objects on the screen. 
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PLOT 


Copies all currently visible segments to the specified 
output device. 


(Option 10) 


[destination] 
[destination-filename] 


PLOT to 


to is a keyword to help you remember the flow of 
the PLOT 


| destination indicates the device to which the 
segments will be copied and the specific file to be 
copied. If no destination is specified, the terminal 
defaults to disk drive O (FO:). Valid devices are: 


HO: the host port 

PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 
FO: disk drive 0 

Fi: disk drive 1 


destination-filename specifies the destination of 
the plot and the specific file to which the plot is to 
be sent. 


if the “destination” parameter is a port that has been 
assigned a 4662 or 4663 driver (see the PASSIGN 
command), terminal commands are converted into 
plotter commands. Otherwise, plots are sent as to the 
specified device as terminal commands. 


if you specify the host as destination, then be sure that 
the host is ready to accept the data, Otherwise you may 
lose your data or cause problems with the host. 


The following command copies the currently visibie 
segments to the file named “picture1” on disk drive 0: 


PLOT to picture1 Cr 


This command copies the segments to the device on 
peripheral port 2: 


PLOT to P2: Snr 
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SET UP COMMANDS 


PORTSTATUS 


Sends to the host a report on the status of the specified 
port. 


(Option 10) 


PORTSTATUS port 


port indicates the port for which a report is to be 
sent to the host computer. Valid ports are: 


PQ peripheral port 0 
P1 peripheral port 1 
P2 peripheral port 2 


In the following command the status report for peri- 
pheral port 1 is sent to the host computer: 


PORTSTATUS P1: Cr 
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PPARITY 


Assigns a Parity mode to the specified port. 
(Memory) 


(Option 10) 


PPARITY port, {odd} 
{even} 
ne 


none} 


port indicates the port for which parity is being 
’ assigned. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 


P2: peripheral! port 2 


odd is a keyword indicating that the value of the 
parity bit is assigned such that the sum of all bits 
in the byte is odd. 


even is a keyword indicating that the value of the 
parity bit is assigned such that the sum of all bits 
in the byte is even. 


high is a keyword indicating that the parity bit is 
given a value of 1. 


none is a keyword indicating that there is no 
parity check. 


A standard ASCIl character with parity would have 
seven data bits (see PBITS) and one parity bit. 


The following command sets the terminal for even 
parity checking on peripheral port 2: 


PPARITY P2:even Cn 
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PROMPTMODE 


Specifies whether or not the terminal is in Prompt 
mode. 
(Memory) 


PROMPTMODE yes} 
{no} 


yes is a keyword which causes the terminal to 
enter Prompt mode. 


no is a keyword which causes the terminal to exit 
Prompt mode. This is the factory default. 


When the terminal is in Prompt mode, data from the 
terminal is stored in a queue and transmitted to the 
host when it is prompted to do so. If you press the 
CANCEL key, the terminal flushes the queue. If you 
turn Prompt mode off, ail the characters in the queue 
are sent to the host. 


The characters used to prompt the terminal are defined 
by the PROMPTSTRING command. After the terminal 
enters Prompt mode, the first prompt string is dis- 
played. Subsequent prompt strings are executed, but 
not displayed. If you press the CANCEL key, Prompt 
mode starts over — that is, the first prompt after 
pressing CANCEL is displayed and subsequent 
prompts are executed. 


The following command would cause the terminal to 
enter Prompt mode: 


PROMPTMODE yes ‘nr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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PROMPTSTRING 


Specifies the prompt sequence. 
(Memory) 


PROMPTSTRING  % string L 


2 is the delimiter character, which must precede 

and follow each parameter. The first character 

after the command word that is not a comma, 

space, or edit character (see EDITCHARS) is the 
delimiter character for this command. | 


string is a delimited string of up to ten ASCII 


characters. The factory default is the null string. 


The prompt string you specify must conform to the 
prompt string actually sent by your host computer. 


The following command is an example of defining a 
prompt string: 


PROMPTSTRING /+&%/ r 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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PROTECT (Options 42/43) 
Specifies the write protect status for a disk or fiie. 
PROTECT [device] [yes] 

[device-filename] [no] 

[filename] 


device indicates the disk drive containing the 


disk that is to be protected or unprotected. Valid 
devices are: 


FO: disk drive O 
F1: disk drive 1 


filename specifies the individual file that is to be 
protected or unprotected. Valid filenames are 
alphanumeric strings of up to nine characters. If 
no device is specified, the terminal defaults to 
disk drive O (FO:). 


yes is a keyword meaning that the file or disk 
should be protected. If you do not specify a 
device or filename, the disk in drive 0 is protect- 
ed. If you specify disk drive 1 and no filename, the 
disk in drive 1 is protected. “Yes” is the default; if 
you do not specify “no” then the file or disk is 
protected. 


no is a keyword meaning that the file or disk 
should be unprotected. If you do not specify a 


device or filename, the disk in drive 0 is unpro- 
tected. If you specify disk drive 1 and no 
filename, the disk in drive 1 is unprotected. 


A protected fiie must be unproiecied before it can be 
deleted or overwritten. A protected disk cannot be 
copied, however it can be reformatted. 

The following command protects the disk in drive 0: 
PROTECT FO: Cr 

This command protects the file named “important” on 
disk drive 1: 

PROTECT F1:important Sr 
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QUEUESIZE 


Specifies the size of the terminal’s input queue. 
(Memory) 


QUEUESIZE bytes 


bytes is an integer, specifying the size of the 


input queue. The factory default is 300. 


When the terminal receives data from the host faster 
than it can be processed, it stores the data in the input 
queue. 


if the input queue fills up and flagging (see FLAGGING) 
is not being used, the terminal ignores incoming data or 
text until there is more room in the queue. If a flagging 
mechanism is being used and the queue fills up, the 
terminal flags the host to stop sending data. When 
there is more room in the queue for more data, the 
terminal flags the host to resume sending data. 


The following command sets the input queue to 500 
bytes: 


QUEUESIZE 500 ‘Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 


6-42 


RENAME (Options 42/43) 


Changes the name of a file on the specified disk. 


RENAME ldevice-oldnamel to [device-newname] 


device indicates the device in which there is a 
disk with a file to be renamed. The terminal 
defaults to disk drive 0 (FO:) if no device is 
specified. The valid device names are: 


FO: disk drive O 
F1: disk drive 1 


oldname is an undelimited alphanumeric string of 
up to nine characters indicating the current name 
of the file. 


to is a keyword which helps distinguish between 
current name of the file and its new name. 


newname is an undelimited alphanumeric string 
of up to nine characters indicating the new name 
of the file. 


An error results if a file already exists with the newly 
specified name. An error also occurs if no file with the 
specified “oldname” exists, or if the file you are 
attempting to rename is write protected (by the WRITE 
PROTECT switch, the write protect notch in the disk, or 
by the PROTECT command). 


The following command changes the file named 
“wrong” to “right” the disk in disk drive 0. 


RENAME FO:wrong to right rn 
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RENEW 


Erases the screen and redraws all visible segments. 
RENEW 


The difference between this command and the PAGE 
key (which also erases the screen and redraws the 
visible, retained segments) is that RENEW never re- 
turns the graphics cursor to the “home” position, while 
the PAGE key does if the dialog area is not enabied. if 
the dialog area is enabled, the PAGE function and 
RENEW commands are identicai. 
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REOM 


Specifies when the “end of message” string is sent ina 
series of graphics input (GIN) reports. 
(Memory) 


REOM (1) 
{0} 
1 specifies that the end of line string is sent after 


each report element and at the end of the report. 
This is the factory default. 


O specifies that the end of line string is sent only 
at the end of the report. 


This command should be set by the applications 
program. If it has not been, you may need to see a 
system programmer for your host system for more 
information. 
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RLINELENGTH SAVE 

Specifies the maximum length of a terminal report sent Saves the specified item(s) to the specified file or 
to the host computer. device. 

RLINELENGTH length SAVE {macro} {id} to [destination-filename] 


{segment} [filename] 


length specifies the maximum length in charac- 
ters for reports the terminal sends to the host 


macro is a keyword indicating that a macro is to 
computer. The factory default is 0. A specification be saved. 


of 0 sets the maximum length to infinity. 


segment is a keyword indicating that a segment 


See the 4110 Series Command Reference Manual for is to be saved. 


details. 


id is an integer parameter identifying the macro 
| ny Amant ta kha ena | 
or segment 10 be Saved. 


Valid macro identifiers for a macro are —1 and 1 
to 32767. If you indicate “all” or —1, all currently 
defined macros are saved. The values 1 to 127 
save the macro associated with the correspond- 
ing ASCII key, 128 to 143 saves macro with the 
the corresponding function keys, and 144 to 
32767 save macros associated with integers. See 
the ASCII chart in Appendix D and the DEFINE 
command for more details. 


Valid segment identifiers are —3, —1,and 1 to 
32767. —3 saves all segments in the current 
matching class, —1 or “all” saves all existing 
segments, and 1 to 32767 save specific 
segments. See the Host Programmer's Reference 
Manual for details. 


to is a keyword which indicates the flow of the 
data: it is saved from the terminal memory (macro 
or segment) to the specified destination. 


destination indicates to which device the data 
should be saved. If no device is specified, the 
terminal defaults to disk drive O (FO:) 


host port 

peripheral port 0 

peripheral port 1 

peripheral port 2 

disk drive O (requires a filename) 
disk drive 1 (requires a filename) 


filename is an undelimited string of up to nine 
alphanumeric characters identifying the file into 
which the macro or segment is to be saved. 
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You can save files to and from the host without the disk 
drive and three port peripheral! ontions. You can save 
files to the disk(s) if you have the disk option(s) 
(Options 42/43). You can use the peripheral ports if 
you have the three port peripheral option (Option 10). 


The macros and segments you save can be put back 
into termina! memory with the LOAD command. 


If you specify the host as destination, then be sure that 
the host is ready to accept the data stream, or you may 
lose your data or cause communications problems with 
the host. 


The following command would save all current seg- 
ments to the device attached to peripheral port 2: 


SAVE segment all to P2: ‘°r 


This command saves macro number 579 in the file 
named “macfile” on the disk in disk drive 1: 


SAVE mac 579 to F1:macfile Cnr 
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SNOOPY 


Specifies whether the terminal should display control 
characters instead of executing any of them. 
SNOOPY yes! 
{no} 


yes is a keyword indicating that Snoopy mode 
should be initiated. 


no is a keyword indicating that Snoopy mode 


shouid be terminated. This is the defauit. The 
“no” specification puts the terminal in Alpha 
mode. 


When the terminal is in Snoopy mode (but not in Setup 
mode) it displays control characters instead of execut- 
ing them. When the terminai is in Setup mode and 
Snoopy mode at the same time, it displays the control 
character and then executes the controi character. 


Since Snoopy mode displays characters which would 
otherwise be executed, it is a handy tool for debugging 
code. 


When in Snoopy mode, characters which are normally 
filtered out during communications to the host are not 
displayed. That means, for example, that even though 
the terminal is in Snoopy mode, the prompt string, 
block headers, and flagging characters are not dis- 
played. 


The termina! displays control characters using the two- 
character abbreviation of control characters shown in 
the ASCII code chart (Appendix D). 


Snoopy mode can aiso be used to examine the 
contents of macros without executing any commands 
in them. To do so, first enter Setup mode and give the 
following command: 


SNOOPY yes Cnr 
After entering this command, exit from Setup mode and 
enter Local mode. Now when you press a key which 


has a macro assigned to it, that macro is displayed but 
not expanded. 


To de-activate snoopy, enter Setup mode and give the 
following command: 


SNOOPY no Sr 
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SPOOL 


Copies data from one device to another, allowing the 
terminal to be used for other functions at the same 
time. 


SPOOL [source] to [destination] 
{filename] [filename] 
{source-filename] [destination- 

filename] 


source indicates the source device. If no source 
is specified, the terminal defaults to disk drive 0 
(FO:). Valid devices are: 


HC: ost pori 
FO: disk drive 0 (requires a filename) 
F1: disk drive 1 (requires a filename) 


filename is an undelimited string of up to nine 
alphanumeric characters identifying the file to be 
copied. This filename must be specified if the 
“source” or “destination” is a disk. 


to is a keyword to indicate the flow of the status 
report -- from the “source” to the “destination.” 


destination indicates the destination device for 
the data being spooled. If no device is specified, 
the terminal defaults to disk drive O (FQO:). Valid 
devices are: 


host port 

peripheral port 0 

peripheral port 1 

peripheral port 2 

disk drive O (requires a filename) 
disk drive 1 (requires a filename) 
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Once initiated, the SPOOL operation proceeds in the 

background, allowing the terminal to be used for other 

operations. Data is transferred from the source to the 

destination without destroying the source copy. 

Spooling continues until: 

® the terminal receives the end-of-file character 

@ the STOP command is issued 

®@ there is a source or destination error 

If the “destination” is a disk drive, an output error can 

result because: 

®@ There is no disk in the destination drive. 

@ The disk in the destination drive is write protected. 

@ The destination disk does not have enough room on 
it for the output file. 


If the last of these errors occurs, you should use a 
different disk. 


If the source is the host, you should either arrange for 
the data to be transmitted for the SPOOL before you 
enter Setup mode, or be aware that after you issue the 
command everything that comes from the host is 
considered data, including the remote character echo. 


Ail characters echoed from the host either before the 
data stream begins or while the data stream is flowing 
are sent to the destination device. 


This command copies “file1” on disk drive O to the 
output device attached to peripheral port 2: 


SPOOL FO:filel to P2: Cr 
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STATUS 


Reports the terminal’s general status, the status of a 
group of related parameters or the setting of an 
individual terminal parameter. 


STATUS [cluster] 
[command] 
{(command-abbreviation] 


SET UP COMMANDS 


The following command generates a general report of 
the status of the terminal (Figure 6-9): 


STATUS Sr 


If no parameter is entered, the terminal displays a 
general report of the terminal’s status. 


cluster is an undelimited alphabetic string 
specifying a status report of a group of related 
parameters. Valid clusters are: 
report/input 
general 
| communications 
optional (optional communications) 


command is an undelimited alphabetic string 
specifying a command for which the terminal | 
should report the status. Valid command names 
include all commands whose parameters are 
stored in the auxiliary backup memory. 

| 


command-abbreviation is an undelimited al- 
phabetic string specifying one command or a 
group of commands ail of which start with ihe 
given abbreviation. 


| dialog (dialog area) | 
— 3PPI 


&STATUS 
TERMINAL STATUS 


poner, 


GENERAL 
EDITCHARS. 2.220500 Oo 
MARGIN... 20s eee cues 2 
PAGEFULL.. 1... eae NONE 
ECHO. cece eee eee NO 
LOCKKLYBOARD....... NO 
KEYEXCHAR. «2... eee 
DAENABLE........005 NO 
IGNOREDEL.......... NO 
LEER oS ieiebe as ateione NO 
CRE seis ana cies aaa NO 
SNOOPY.. 2... 0.002 eee NO 
ERRORLEVEL.......4. 4) 

DIALOG 
DABUFFER.... 2.2.06. 1S 


COMMUNICATIONS 
BAUDRATE «.. 2408 2420 
XMTLIMIT 9202 
STOPBITS 
XMTDELAY 
PARITY 


RN 
EOLSTRING.......... ‘R’ 
EOFSTRING.......... i 
BREAKTIME... 1-0. ene 208 
BYPASSCANCEL....... iF 


OPTIONAL COMM 
FULL 


DUPLEX... eee eae 
BLOCKMODE.......... NO 
BHEADERS........+-- ‘HEADTX’ ‘HEADRX ’ 
BLENGTH.. 1. ee ee eee 256 256 

BCONT INUECHARS..... & & 
BENDCHARS.........- $$ 
BMASTERCHARS....... # # 

BLINELENGTH. ....-es 728 
BPACKING........... i 676 


‘HS HSE! 


Figure 6-9. The STATUS Report. 
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This command generates a report of the status of 
commands relating to the dialog area (Figure 6-10): 


STATUS DIALOG Sn 


This command causes the terminal to report the status 
of the BAUDRATE command (Figure 6-11): 


STATUS BAUDRATE Cn 


When you abbreviate the name of a command, the 
terminal reports the status of all commands with the 
same spelling up to the letters you specified. For 
example, if you enter the following command the 
terminal reports the status of all commands beginning 
with the character “E” (Figure 6-12): 


STATUS E Sr 


If you request a report for a command that is not stored 
in the terminal’s setup memory, there is no response. 
The cursor moves to the next line and displays the 
Setup mode prompt (*). 


*STATUS DIALOG 

DIALOG 
DABUFFER.... 1S 
DACHARS.... 73 
DALINES.... ) 
DAMODE..... REPLACE 


DAPOSITION. 0,2 
DAVIS. ..... . NO 


Figure 6-10. The Dialog Area STATUS Report. 


*STATUS BAUDRATE 


BAUDRATE........++. 2488 2408 
* 


Figure 6-11. The STATUS BAUDRATE Report. 


STOP 


Halts the current “spooling” operation. 
STOP 


When a spool is halted, the output file is closed and all 
data that has already been transferred is saved. 


The command is ignored if no spool is in progress. 


| . AvTit | | 


xSTATUS E 


EDITCHARS.......... 8 W 7 
ECHO Ss. ses. ca a tae, -NO 
ERRORLEVEL......... 9 
EOMCHARS. «2-222 ee RN 


EOUSTRING ns. oiew edn. “® 
EOFSTRING.......222 7" 


x 


Figure 6-12. The STATUS E Report. 
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STOPBITS 


Specifies the number of stop bits used at the end of 
each character transmited from the terminal. 


STOPBITS (1) 
{2} 


1 indicates that the terminal appends one stop 


bit. This is the factory default. 


2 indicates that terminal appends two stop bits. 
a ee eee eee 
The purpose of the “stop bit” is to indicate the 
completion of the transmission of a data byte. 


The following command sets the terminal to transmit 
two stop bits at the end of each byte: 


STOPBITS 2 Sr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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TBFILTER 


Specifies the time or distance between points entered 
per stroke when the graphics tablet is in use. 


(Options 13/14) 


TBFILTER device, distance, time 


device is an integer parameter indicating the 
graphic input device to which this filter specifica- 


tion applies. Valid graphics input (GIN) devices 
are: 


‘“ £ jog ai 
8 tablet for “locator” function 


9 tablet for “pick” function 
10. tablet for “stroke” function 


distance is an integer parameter specifying the 
minimum distance the graphics cursor or pen 
must travel before another point is transmitted to 
the program. The valid range is from 0 to 4096. 
The default is 0. 


time is an integer parameter specifying the 
minimum number of milliseconds that elapse 
between successive points transmitted to the 
program. The valid range is from 0 to 65535. The 
default is 0. 


The following command sets the graphics tablet to 
locate every 100th point every 100 milliseconds: 


TBFILTER 10 100 100 ‘Sn 
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TBHEADERCHARS (Options 13/14) 
Specifies the header and key characters used in 

graphics input reports. 
TBHEADERCHARS letters} 
{control} 


O letters specifies the characters M, J, and O as the 
header characters. This is the default. 


1 control specifies the control characters (GS), 
(SUB), and (US) to be the header characters. 


This emulates the HEADER stran on the TEKTRONIX 
4953 Graphics Tablet control board found in 4010- 
family terminals. For more details see the description of 
<set-tablet-status-strap> command in the 4110 
Series Command Reference Manual. 
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TBSTATUS (Options 13/14) 


Specifies whether or not the terminal status byte is 


sent when the graphics tablet pen is lifted away from 
the tablet surface. 


TBSTATUS {0} 
{1} 


O specifies that the status byte is not sent when 


the tablet pen is lifted away from the tablet 
surface. This is the default. 


1 specifies that the status byte is sent when the 
tablet pen is lifted away from the tablet surface. 


This emulates the HEADER strap in the TEKTRONIX 
4953 Graphics Tablet board in 4010-style terminals. 
For more information, see the description of < set- 
tablet-status-strap> command in the 4110 Series 
Command Reference Manual. 
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XMTDELAY 


Specifies the length of time for which transmission of 
data to the host is halted after the terminal encounters 
an end of message character (see EOMCHAR). 


XMTDELAY ms 


ms is an integer parameter representing the 
number of milliseconds delay in transmission. 
The acceptable range of values is from 0 to 


| 65535; the factory default is 100. | 
The following command sets the transmit delay to 300 
milliseconds: 


XMTDELAY 300 Cr 


Po oes 


This parameter may be set by afi applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consuit with a 
system programmer for your host computer before 
using this command. 
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XMTLIMIT 


Specifies the upper limit for data transmission from the 
terminal to a host computer. 
(Memory) 


XMTLIMIT limit 


limit is an integer parameter indicating the fas- 
test rate at which the terminal is to send data toa 


host. The range of valid values is from 110 to 
65535; the factory default is 19200. 


If the host computer cannot effectively receive data at 
the rate at which the communications port is specified, 
you can use XMTLIMIT to cause the termina! to pace 
its transmission of data at the given limit. This lowers 
the effective baud rate without altering the baud rate 
itself. 


The following command sets the transmit limit to 1800 
bits per second. 


XMTLIMIT 1800 Cr 


This terminal operating parameter is host dependent. It 
should usually be set by an application program when 
it is executed from the host. If it is not, see a system 
programmer for your host computer for more 
information. See the 4110 Series Command Reference 
Manual for additional details. 
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Appendix A 


ERROR CODES 


INTRODUCTION 


Each error condition which the terminal can detect has 
an “error code” and a “severity level.” 


When the terminal detects an error condition, it stores 


the error code in a limited-size queue for later retrieval 


by a <report-errors> command. 


If the error’s severity level is greater than or equal to 
the current error levei, then the terminal dispiays a 
message for the operator. (The error level is deter- 
mined by the most recent ERRORLEVEL command.) 


SEVERITY LEVELS 


There are four severity levels, numbered from zero to 
three: 


@ Level 0. Errors of severity level zero are hardly 
errors at all. The associated message begins with 
the words “Terminal issues message ....” Typically, 
these errors occur for commands which are not 
installed. For instance, when 4112 commands are 


sent to a 4114, the terminal detects level zero errors. 


@ Level 1. Level one errors are “warnings.” The 
corresponding messages begin with the words “Ter- 
minal issues warning ....” Typically these occur 


when the command is inannronriate: deleting a 


i wwe 


segment that does not exist, for example. 


® Level 2. Level two errors result from invalid com- 
mands. For instance, a command’s parameter may 
be outside the specified range. The corresponding 
message begins with the words, ‘Terminal detects 
error....” 


@ Level 3. Level three errors occur when the com- 
mand is valid, but for some reason the terminal 
cannot execute the command. (For instance, there 
may be insufficient memory to hold all the informa- 
tion being included in a segment definition.) For 
these errors, the message starts with the words, 
“Terminal system error....” 
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COMMANDS NOT INSTALLED IN THE 
TERMINAL 


When the terminal receives an escape-sequence com- 
mand which it does not recognize, it detects the 
appropriate error message (of severity level zero). After 
detecting the error, the terminal then ignores all 
subsequent characters until it receives an &c, Ss, Fs, or 
Us character. (It does this so as to skip over any 


parameters for the unrecognized command.) 


For instance, suppose the terminal does not have 
ption 1 installed, and the host sends it the following 
character sequence: 


Ec(O)(D)(0)Ec(K) (A) (1) 


Since Option 1 is not installed, the terminal does not 
recognize the < set-duplex-mode: 0> command, 
E¢(O)(D) (0). On receiving the §c(O)(D) op code, the 
terminal detects a type ODOO error (and displays the 
ODOO error message if the error threshold is set to 
zero). It ignores the following character, (0). On receiv- 
ing the following £c, the terminal resumes processing of 
the characters received, so that it correctly interprets 
and executes the < enable-dialog-area: 1> command, 
Eo(K)(A)(1). 


If your host program sends commands which may not 
be installed in all 4110-series terminals, then it should 
follow those commands with other commands which 
are recognized by all terminals in the series. For 
instance, after issuing commands to change 411 2-only 
settings, the host could send a Ys character (the 
<enter-alpha-mode> command) before sending any 
alphatext to the terminal. That way, if the terminal is a 
4114 rather than a 4112, the Y's character causes the 
terminal to resume normal processing of the characters 
it receives. 
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ERROR CODES 


The error codes are each composed according to the 
following scheme: 


e@ Each error code consists of four characters. 


@ in most error codes, the first two characters are the 
op code for some command: the command being 
executed when the error is detected. For example, 
error 1A11 is associated with the PICKAPERTURE 
command. 


Some errors, however, are associated with no parti- 
cular command. For these errors, the first two 


characters are a letter and a digit. For instance. error 


1011 (invalid device-function code) can occur with 
many graphic input commands. Again, error J109 
(disk hardware initialization error) can occur only 
when the terminal is turned on, before any com- 
mands have been sent to it. 


®@ The third character in an error code is a numeric 
digit. Digits from 1 to 9 name the parameter with 
which the error is associated. Digit 0 indicates that 
the error is associated with the command as a 


whole: the op code itself is regarded as the “zeroeth 


parameter.” 
@ The fourth character in an error code is also a digit. 


The most frequently used digits here are O, 1, 2, and 


3: 
0: Indicates an “existence problem.” The 


object referred to does not exist when it ought 


to exist, or does exist when it ought not to 
exist. 


1 : Indicates an “invalid value.” 
2: Indicates an “out of memory problem.” 


3: A“context error.” The command is valid, 
but cannot be executed at this time. (For 
instance, trying to end a segment when no 
segment is currently being defined.) 


For example, consider the “JD10” error code. Here, 


“JD” means the DIRECTORY command. The “1” refers 


to the first parameter of that command, which is the 
device. The “0” indicates an “existence problem,” 
there is no such device. 


A-2 


DISK HARDWARE ERRORS 


For some disk system errors (“type 9” errors such as 
JC19, JC39, JD19, etc.), the error code reports a “disk 
hardware error number.” Table A-1 lists the disk 
hardware errors: 

Table A-1 


DISK HARDWARE ERRORS 


Error Number Explanation 


Cannot complete result phase. 
Cannot sense drive status. 
Cannot sense interrupt status. 
ROM wrong state. 

(Reserved) 

(Reserved) 

Invalid command. 

Bad track. 

Control mark. 


=-=§ © On OO A F&F WO NH 
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CRC (cyclic reduncy check) 
error. 


Missing address data. 
Missing address mark. 
No data. 

Wrong cylinder. 
Overrun. 

(Reserved.) 

Not two-sided. 


Failed command phase (bytes 
not output). 


oe ee ee ee a eS 
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DISK SYSTEM CONTEXT ERRORS 


For some disk system errors (“type 3” errors such as 
JC13, JC33, JD33, etc.), a supplemental error message 
may be displayed. This supplemental message 
describes the type of “context error” which has 
occurred. Table A-2 lists these context error types: 
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Table A-2 
DISK SYSTEM CONTEXT ERROR 


Explanation 


Tried to open for input a file 
which is already open for out- 

put; or, tried to open for output 
a file which is already open for 
input. 


File Already Open 


No FCB No File Control Block is avail- 
able when opening a file; or, 
| the File Controi Block has 


been destroyed. 


A “secure volume” is a disk- 
ette (usually holding proprieta- 
ry software) which cannot be 
copied. (However, files can be 
<{load> ed from a SECuUTE VOI- 
ume, and a directory can be 

! obtained with the <directory> 
command. 


Secure Volume 


Explanation 


Directory Full This diskette already contains 
the maximum number of files 


for which it was formatted. 


Tried to close a file which is 
not currently open. 


File Not Open 


Unsuccessful attempt to 
terminate the writing of a file. 
(The file being written be- 
comes inaccessible.) 


File Trailer Error 


Directory Update Error Error in attempting to update 
| the disk directory on the disk- 


ette. 


i ive Vetitetel Err, 


Direction £ Tried to read from a file which 


was opened for output; or, tried 
| to write to a file which was 

opened for input. 
ee ee 


ERROR CODES 


The remainder of this appendix lists the specific error 
codes. They are listed alphabetically, according to the 
op code associated with each command. 


if the command has an English-like Setup mode 
equivalent, it is indicated. If there is not, only the 
escape sequence format for the command is shown. 


10 (For several GIN commands.) 


NOTE 


Ec may appear as (ESC) in other manuals. How- 
ever, in this manual, it is shown as €c. 


{002 (Level 2): Insufficient memory available for GIN functions. 
i011 (Level 2): Invalid device-function code. (See the description of the <enable-GIN> command for a table of 
device-function codes.) 


11 <Enable-4953-Tablet-GIN> 
< Disable-4953-Tablet-GIN> Ec(1)(1)< ASCll-char> 


1100 (Level 2): Unrecognized command (Option 13 or 14 not installed). 


1A PICKAPERTURE=< Set-Pick-Aperture> =®c(I)(A)< int> 
1A11_ (Level 1): Invalid aperture width (must not be in the range from O to 4095). 


IC  <Set-GIN-Cursor> =®c(I)(C)<int> <int> 

1C13 (Level 2): Graphic input has already been enabled for the specified device-function code. 
IC20 (Level 2): Segment does not exist, or is currently being defined. 

1C21 (Level 2): Invalid segment number (must be in the range 0 to 32767). 
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IE <Enable-GIN> ==c(I)(E)<int> <int+> 


1EOO (Level 2): the cursor segment for the specified device-function code does not exist. (It has been deleted 
since the < set-GIN-cursor> command which assigned it to that device-function code.) 


1E03 (Level 2): Command is invalid at this time. (The segment being used as the cursor for the specified device- 
function code is a segment which is currently being defined.) 


1E10 (Level 2): The specified GIN device is not installed in the terminal. 
1E13 (Level 2): The specified device is already enabled. 
1E21 (Level 2): Invalid number of GIN events (must be in the range from 1 to 65535). 


IF TBFILTER=< set-GIN-Stroke-Filtering> =€c(I) (F)< int> <int> <int> 
IFOO (Level 2): Unrecognized command. (The tablet option is not installed.) 


IF10 (Level 2): Stroke filtering does not apply to the specified device-function code. (Stroke filtering applies only 
to the stroke function on the tablet device.) 


IF21 (Level 2): Invalid filtering distance (must be in the range from 0 to 4095). 
IF31 (Level 2): Invalid filtering time (must be in the range from 0 to 32767). 


IG GRIDDING=< Set-GIN-Gridding> =*c(I)(G)< int> <int> <int> 


IG10 (Level 2): Gridding does not apply to the specified device-function code. (Gridding is not allowed for the 
stroke function.) 


1G21 (Level 2): Invalid x-spacing (must be in the range from 0 to 4095). 
IG31_ (Level 2): Invalid y-spacing (must be in the range from 0 to 4095). 


1H TBHEADERCHARS=< Set-Tablet-Header-Characters > =*c(I)(H)< int> <int> 
IHOO (Level 0): Unrecognized command. (Tablet option is not installed.) 
IH11 (Level 2): Invalid parameter (must be O or 1; in Setup mode, must be CONTROL or LETTERS). 


rT] < Set-GIN-inking> =®c(I)(I) < int> <iInt> 


1111 (Level 2): Inking does not apply to the specified device-function code. (Inking is not allowed for the pick 
function.) 


1121 (Level 2): Invalid Inking mode (must be 0 or 1). 


IL < Set-Report-Max-Line-Length> =®c(I)(L)< int> 
1L11 (Level 2): Invalid maximum report line length (must be in the range from 0 to 65535). 


IM REOM=< Set-Report-EOM-Frequency> = c(1)(M)< int> 
IM11 (Level 2): Invalid report-EOM-frequency setting (must be 0 or 1). 


IP = < Report-GIN-Point> =€c(1)(P)<int> 


IP13 (Level 2): The device-function code names a device which has already been enabled for a different graphic 
input function. 


1Q < Report-Terminal-Settings> =*c(I)(Q)< char> <char> 
No errors are detected for this command. 
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IR < Set-GIN-Rubberbanding> =*c(I)(R)< int> <int> 


iRiO (Levei 2): Rubberbanding does not appiy to the specified device-function code. (Rubberbanding is oniy 
allowed for the locator function. It is forbidden for the pick and stroke functions.) 


IR21 (Level 2): invalid Rubberbanding mode (must be O or 1). 


Is < Set-Report-Sig-Chars> = c(I)(S)<int> <char> <char> 

IS11 (Level 2): Invalid report type code (must be valid device-function code, or in the range from —1 to —3). 
1S21 (Level 2): Invalid second parameter (must be in the range from O to 127). 

1S31 (Level 2): Invalid third parameter (must be in the range from 0 to 127). 


IT TBSTATUS=< Set-Tablet-Status-Strap> = c(I)(T)<int> 

ITOO (Level 0): Unrecognized command. (The tablet option is not installed.) 
IT11 (Level 2}: Invalid strap setting (must be 0 or 1). 

JO and J1: Disk System Errors on Power-Up 

JO02. (Levei 3): Memory error detected by standard firmware. 

J102 (Level 3}: Memory error detected by optiona! peripheral! firmware. 
J109 (Level 3): Hardware initialization error in Disk Controller board. 


JC COPY=<Copy> ="e(J)(C)< string> <string> <string> 

JCO3 (Level 2): Attempt to copy an entire disk volume onto itself (e.g., a copy from FO: to FO:). 
JC10 (Level 2): Specified source device does not exist. 

JC11 (Level 2): Invalid source device specifier. 


JC12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the first parameter, or while executing 
the command.) 


JC13 (Level 2): Parameter 1 context error (not an input device). 

JC19 (Level 2): Disk hardware error or drive not ready on the source disk drive. 

JC2i (Levei 2): invaiid separator string (must be empty string or “TO"). 

JC22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the separator string.) 
JC30 (Level 2): Specified destination device does not exist. 

JC31 (Level 2): Invalid destination specifier. 


JC32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the third parameter, or while executing 
the command.) 


JC33 (Level 2): Parameter 3 context error (not a valid destination device). 
JC39 (Level 2): Disk hardware error or drive not ready on the destination diskdrive. 


JE STOP=< Stop-Spooling> =€c(i)(T) 
No errors are detected for this command. 
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JD  DIRECTORY=< Directory> =*c(J)(D)<string> <string> <string> 
JDOO (Level 2): Unrecognized command. (Disk drive option is not installed.) 
JD10 (Level 2): The device for which the directory is requested does not exist. 
JD11 (Level 2): Invalid input device specifier in parameter 1. 


JD12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the source string, or while executing the 
command.) 


JD13 (Level 2): Context error in parameter 1. (The specified device is not a disk drive, or failed reading bit map.) 
JD19 (Level 2): Disk hardware error (or drive not ready) for the disk drive whose directory is being requested. 
JD21 (Level 2): Invalid separator string (must be empty string or “TO”). 

JD22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the separator string.) 

JD20 (Leve! 2}: The specified destination device does not exist. 

JD31 (Level 2): Invalid destination device specifier. 


JD32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the destination string, or while executing 
the command.) 


JD33 (Level 2): Parameter 3 context error. (The device specified is not a valid destination device, or is write- 
protected.) 


JD39 (Level 2): Disk hardware error for the destination device. (I/O error, write-protect error, or disk drive not 
ready.) 

JF  FORMAT<Format-Volume> =£c(J)(F)< string> <int> 

JFOO (Level 2): Unrecognized command. (Disk drive option not installed.) 

JF10 (Level 2): Device does not exist or is not installed. 

JF11 (Level 2): Invalid device specifier. 

JF12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the device specifier string.) 


JF13 (Level 2): The device specified in parameter 1 (a) is not a disk drive, (b) is write protected, (c) is busy, (d) 
detects a verify error, or (e) detects a bit map error. 


JF19 (Level 2): Hardware error at the specified disk drive. (Format error, drive not ready, or write-protect switch or 
notch error.) 

JK  DELETE=<Delete-File> = c(J)(K)<string> 

JKOO (Level 2): Unrecognized command. (Disk drive option is not installed.) 

JK10 (Level 2): The specified file or disk drive does not exist. 

JK11 (Level 2): Invalid device specifier. 

JK12 (Level 3): Parameter 1 memory error. (Out of memory while parsing parameter 1.) 

JK13 (Level 2): The specified device (a) is not a disk drive, (b)is write-protected, or (c) detects a bit map error. 

JK19 (Level 2): Disk hardware error. (I/O error, drive not ready, or hardware write-protect error.) 
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JL LOAD=<Load> =®c(J)(L)< string> 


JLO2 (Level 3): 
JLO3 (Level 2): 
JLiO (Level 2): 
JL11 (Level 2): 
JL12 (Level 3): 


JLi3 (Level 2): 


JLi9 {Level 2): 


Out of memory whiie performing <ioad> command. 
Nesting error. (< Load> commands are nested too deeply.) 
File or device does not exist. 

Invalid file specifier. 


Parameter 1 memory error. (Out of memory while parsing parameter 1, or while executing the 
command.) 


Context error in parameter 1. (Not a valid source device.) 


Disk hardware error or drive not ready. 


JP PROTECT=<Protect-File>=&c(J)(P)< string> <int> 


JPOO (Level 2): 
JP10 (Level 2): 


JPii. {Level 2): 
JP12 (Level 3): 
JP13 (Level 2): 


JP19 (Level 2): 
JP21 (Level 2): 


Unrecognized command. (Disk drive option is not installed.) 

The specified file or disk drive does not exist. 

nvalid file specifier. 

Parameter 1 memory error. (Out of memory while parsing parameter 1) 


Either the specified device is not a disk drive, or the file (or entire diskette volume) has been write- 
protected. 


Disk hardware error. (i/O error, drive not ready, or hardware write-protect error) 
invalid Protection mode (must be 0 or 1). 


JQ = <Report-Device-Status> =c(J)(Q)< string> 


JQO0 (Level 2): 
JQ10 (Level 2): 
JQ11 (Level 2): 
JQ12 (Level 3): 


Unrecognized command. (Disk drive option is not installed.) 

Device does not exist or is not installed. 

Invalid device specifier. 

Parameter 1 memory error. (Out of memory while parsing parameter 1)) 


JR | RENAME=<Rename-File> =®c(J)(R)< string> <string> <string> 


JROO (Level 2): 
JR10 (Level 2): 
JR11 (Level 2): 
JR12 (Level 3): 
JR13 (Level 2): 


JR19 (Level 2): 
JR21 (Level 2): 
JR22 (Level 3): 
JR30 (Level 2): 
JR31 (Level 2): 
JR32 (Level 3): 
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Unrecognized:command. (Disk drive option is not installed.) 

The specified device or file does not exist. 

Invalid “old” file specifier. 

Parameter 1 memory error. (Out of memory while parsing parameter 1) 


Either the device specified in parameter 1 is not a disk drive, or the file (or entire diskette) has 
been write-protected. 


Disk hardware error. (I/O error, drive not ready, or hardware write-protect error.) 

Invalid separator string (must be empty string or “TO”). 

Parameter 2 memory error. (Out of memory while parsing parameter 2) 

Either the device specified in parameter 3 does not exist, or the “new” filename already is in use. 
Invalid device specifier in parameter 3. 

Parameter 3 memory error. (Out of memory while parsing parameter 3.) 
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JS  SPOOL=< Spool> = c(J)(S)< string> <string> <string> 
JSO3 (Level 2): Command context error. (A spooling operation is already in progress.) 
JS10 (Level 2): Specified source device does not exist. 


JS11 (Level 2): Invalid source specifier. (Must be “HO:”, “PO:”, “P1:", “P2:", or a file specifier such as “FO: 
FILENAME”. Specifying only the disk drive — such as “FO:” or “F1:" — is not allowed.) 


JS12 (Level 3): Parameter 1 memory error. (Out of memory while parsing parameter 1, or while executing the 
command.) 


JS13 (Level 2): Parameter 3 context error. (Not a valid input device.) 

JS19 (Level 2): Disk hardware error or drive not ready on the source disk drive. 

JS21 (Level 2): Invalid separator string (must be empty string or “TO”). 

JS22 (Level 3): Parameter 2 memory error. (Out of memory while parsing parameter 2.) 
JS30 (Level 2): Specified destination device does not exist. 

JS31 (Level 2): Invalid destination device specifier. 


JS32 (Level 3): Parameter 3 memory error. (Out of memory while parsing parameter 3, or while executing the 
command.) 


JS33 (Level 2): Parameter 3 context error. (Not a valid destination device.) 
JS39 (Level 2): Disk hardware error or drive not ready on the destination disk drive. 


JV SAVE=< Save> = "c(J)(V)< string> <int> <string> <string> 
JV11 (Level 2): Invalid type-of-save string. (Must be MAC or SEG) 


JV12 (Level 3): Parameter 1 memory error. (Out of memory while parsing paramter 1, or while executing the 
command.) 


JV20 (Level 2): The specified macro definition or segment does not exist. 

JV21 (Level 2): Invalid item number or count. 

JV31 (Level 2): Invalid separator string (must be empty string or “TO”). 

JV32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the separator string, 
JV40 (Level 2): The specified destination device does not exist. 

JV41 (Level 2): Invalid destination device specifier. 


JV42 (Level 3): Parameter 4 memory error. (Out of memory while parsing the destination string, or while executing 
the command) 


JV43 (Level 2): Parameter 4 context error. (Not a valid destination device.) 


JV49 (Level 2): Disk hardware error on destination disk drive (I/O error, drive not ready, or hardware write-protect 
error). 


KO: Keyboard System Errors 
KO ~— (Level 3): Out of memory while initializing the keyboard system. 
KA DAENABLE=< Enable-Diatog-Area>=®c(K)(A)<int> 


KA11 (Level 2): Parameter out of range (must be 0 or 1). 


KC <Cancel> = *c(K)(C) 
No errors are detected for this command. 
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KD DEFINE=<Define-Macro> = c(K)(D)< int> <int-array> 
KDii (Levei 2): invaiid macro number (musi be in range —i to 32767). 


KD21 (Level 2): Invalid character-code in <int-array>. (Character codes must be in the range from 0 to 127. The 
array count must be in the range from 0 to 65535.) 


KD22 (Level 3): Insufficient memory to define macro. 

KE ECHO=<Echo> = "c(K)(E)<int> 

KE11 (Level 2): Invalid Echo mode (must be 0 or 1). 

KF LFCR=< LFCR> ="c(K)(F)<int> 

KF11 (Level 2): Invalid LFCR mode (must be 0 or 1). 

KH <Hardcopy> = c(K)(H)<int> 

KH11 (Level 2): Invalid hardcopy code (must be 0, 1, or 2). 

KI IGNOREDEL=< Ignore-Deletes> = c(K) (I) <int> 

KI11 (Level 2): Invalid Ignore-Deletes mode (must be 0 or 1). 
KL LOCKKEYBOARD=< Lock-Keyboard> =c(K)(L)<int> 
KL11 (Level 2): Invalid Keyboard-Lock mode (must be 0 or 1). 
KM MARGINS=< Set-Margins> = *c(K)(M)<int> 

KMOO (Level 0): Unrecognized command. 

KM11 (Level 2): Invalid number of margins (must be in the range from 1 to 8). 


KN RENEW=< Renew-View> = c(K)(N)<int> 


KN11 (Level 2): Parameter out of range (must be in the range from —32768 to + 32767). (This parameter should 
be in the range from —1 to 64; however, the terminal will substitute —1 in place of a value which is 
less than —1, and + 64 in place of a value in the range from 65 to 32767.) 


f 


KP PAGEFULL=< Seit-Page-Fuii-Action> ="ciK) 
KP11 (Level 2): Invalid page-full-action code (must b 
KQ = <Report-Errors > =®c(K)(Q) 

No errors are detected for this command. 

KR CRLF=<CRLF> =c(K)(R)<int> 

KR11 (Level 2): Invalid “CR-implies-LF” mode (must be 0 or 1). 
KS SNOOPY=<Snoopy> =c(K)(S)<int> 

KS11 (Level 2): Invalid parameter (must be 0 or 1). 


KT ERRORLEVEL=< Set-Error-Threshold> = c(K)(T)< int> 
KT11 (Level 2): Invalid error threshold (must be in range from 0 to 4). 
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KX  <Expand-Macro> = "c(K)(X)<int> 


KX01 (Level 2): The maximum nesting depth (for <expand-macro> and <load> commands) has been exceeded. 
(The nesting depth should not exceed five. Greater nesting depths may result — but do not 
necessarily result — in type KX01 errors.) 


KX02 (Level 3): Out of memory while performing <expand-macro> command. 
KX11 (Level 2): Invalid macro identifier (must be in the range from 0 to 32767). 


KY KEYEXCHAR=< Set-Execute-Toggle-Char> = c(K)(Y)<int> 

KY11 (Level 2): Invalid <key-execute-toggle> code (must be in range 0 to 127). 

KZ EDITCHARS=< Set-Edit-Chars> =€c(K)(Z)< int> <int> <int 

KZ11 (Level 2): Invalid char-delete character (must be in the range from 0 to 127). 

KZ21 (Levei 2): invaiid iine-delete characier (musi be in ine range from 0 to 127). 

KZ31 (Level 2): Invalid take-literally character (must be in the range from 0 to 127). 

LB DABUFFER=< Set-Dialog-Area-Buffer-Size> = c(L)(B)< <int+> 

LB11 (Level 2): Invalid number-of-lines parameter (must be in the range from 2 to 65535). 
LC DACHARS=<Set-Dialog-Area-Chars> =®c(L)(C)<int+> 

LC11 (Level 2): Invalid number of characters per line (must be in the range from 5 to 819). 
LF <Move>=c(L)(F)<xy> 

No errors are detected for this command. 

LG = <Draw>=®c(L)(G)<xy> 

No errors are detected for this command. 

LH <Draw-Marker> =®c(L)(H)<xy> 

No errors are detected for this command. 

LK <Include-Copy-of-Segment> =®c(L)(K)<int> 

LKO2 (Level 3): Out of memory while performing < include-copy-of-segment> . 

LK10 (Level 2): Segment does not exist. 

LK11 (Level 2): Invalid segment number (must be —3, —1, or in the range from 1 to 32767) 
LiL DALINES=< Set-Dialog-Area-Lines> =c(L)(L)<int+> 

LL11 (Level 2): Invalid parameter (must be in the range from 2 to 520). 

LM DAMODE=< Set-Dialog-Area-Writing-Mode> =&c(L)(M)<int> 

LM11 (Level 2): Invalid Writing mode (must be 0 or 1). 


LT  <Graphic-Text>=c(L)(T)< string> 


LT11 (Level 2): Invalid graphtext string. Invalid array count (must be in the range from 0 to 32767), or invalid 
<char> character in the array (must be in the range from ADE value 26 [space] to 126 [tilda]). 


LT12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the <string> parameter.) 


2) 
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LV DAVIS=< Set-Dialog-Area- Visibility > ==c(L)(V)<int> 
LVO3 (Levei 0): One or more of the diaiog area parameters was altered wren the dialog area was made visible. 
LV11. (Level 2): Invalid dialog area visibility mode. (Must be 0 or 1; in Setup mode, must be YES or NO.) 


LX DAPOSITION=< Set-Dialog-Area-Position> =®c(L) (X)< xy> 

No errors are detected for this command. 

LZ  <Clear-Dialog-Scroll>=*c(L)(Z) 

No errors are detected for this command. 

MC  <Set-Granhtext-Size> ="c(M)(C)<int> <int> <int> 

MC11 (Level 2): Invalid value in parameter 1 (must be in the range from 1 to 4095). 
MG21 (Level 2): Invalid value in parameter 2 (must be in the range from 1 to 4095). 
MC31 (Level 2): Invalid value in parameter 3 (must be in the range from 0 to 4095). 

ME <Set-Granhtext-Font> =€c(M)(F)<int> 

MF10 (Level 2): Font does not exist. 

MF11 (Level 2): Invalid font number (must be in the range 0 to 32767). 

Mi < Set-Pick-ID> =£c(M)(I)<int> 

MIO3 (Level 2): Command is invalid at this time (no segment is currently being defined). 
MI11 (Level 2): Invalid pick identification number (must be in the range from 0 to 32767). 


ML <Set-Line-Index> ="c(M)(L)<int+> 
ML11 (Level 2): Invalid line index (must be in the range from 0 to 32767). 


MM < Set-Marker-Type> =£c(M)(M)<int> 

MM11 (Level 2): Invalid marker type (must be in the range from 0 to 10). 
MQ <Set-Graphtext-Precision> = c(M)(Q)< int> 

MQ11 (Level 2): Invalid Precision mode (must be 1 or 2). 


MR <Set-Graphtext-Rotation> =&c(M)(R)<real> 
MR11 (Level 2): Invalid rotation angle (must be in the range from —32767.0 to + 32767.0). 


MT <Set-Text-Index> = c(M)(T)<int+> 
MT14 (Level 2): Invalid text index (must be in the range from O to 65535). 


MV <Set-Line-Style> =&c(M)(V)< int> 
MV11 (Level 2): Invalid line style (must be in the range from 0 to 7). 


MW <Set-Line-Width> =®c(M)(W)<int> 
MWOO (Level 0): Unrecognized command. 
MW11 (Level 2): Invalid line width (must be either O or 1). 
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ERROR CODES 


MZ 

MZOO 
M211 
MZ21 
MZ31 


NB 
NB11 


NC 
NC11 
NC21 


ND 
ND11 


NE 
NE11 


NE12 


NF 
NF11 
NK 
NK11 
NL 
NL11 
NM 
NM11 
NP 
NP11 
NQ 
NQ02 
NQ11 


NR 
NR11 


NR21 


ALPHASIZE=< Set-Alphatext-Size> = c(M)(Z)<int> <int> <int> 

(Level 0): Unrecognized command. 

(Level 2): Invalid size multiplier (must be in the range from 1 to 15). 

(Level 2): Invalid inter-character spacing (must be in the range from 0 to 15). 
(Level 2): Invalid inter-line spacing (must be in the range from 0 to 255). 


STOPBITS=< Set-Stop-Bits> =®c(N)(B)<int> 

(Level 2): Invalid number of stop bits (must be 1 or 2). 

EOMCHARS=< Set-EOM-Chars> =c(N)(C)< int> <int> 

(Level 2): Invalid value in parameter 1 (must be in the range from 0 to 127). 
(Level 2): Invalid value in parameter 2 (must be in the range from 0 to 127). 
XMTDELAY=< Set-Transmit-Delay> =®c)w)(o)<int> 

(Level 2): Invalid transmit delay time (must be in the range from 0 to 65535 ms). 


EOFSTRING=< Set-EOF-String> = §c(N)(E)<int-array> 


(Level 2): Invalid EOF-string (must contain from O to 10 characters, with each character represented by an 
<int> in the range from 0 to 127). 


(Level 3): Parameter 1 memory error (out of memory while parsing the <int-array> parameter). 
FLAGGING=< Set-Flagging-Mode> =§c(N)(F)<int> 

(Level 2): Invalid Flagging mode (must be in the range from 0 to 4). 
BREAKTIME=< Set-Break-Time> =£c(N)(K)< int+> 

(Level 2): Invalid parameter. (Must be in the range from 0 to 65535) 
XMTLIMIT=< Set-Transmit-Rate-Limit > =&c(N)(L)<int+> 

(Level 2): Invalid transmit rate limit. (Must be in the range from 110 to 65535.) 
PROMPTMODE=< Prompt-Mode> = c(N)(M)< int> 

(Level 2): Invalid Prompt mode parameter (must be 0, 1,0r 2). 

PARITY=< Set-Parity > =€c(N)(P)<int> 

(Level 2): Invalid parity code (must be in the range from O to 4). 

QUEUESIZE < Set-Queue-Size> = c(N)(Q)<int+> 

(Level 3): Out of memory while performing <set-queue-size> command. 
(Level 2): Invalid queue size (must be in the range from 1 to 65535). 


BAUDRATE=< Set-Baud-Rates> =®c(N)(R)< int+> <int+> 


(Level 2): Invalid transmit (terminal-to-host) data rate (must be 1, 50, 75, 110, 134, 150, 300, 600, 1200, 
1200, 1800, 2000, 2400, 4800, 9600, 19200, or 38400). 


(Level 2): Invalid receive (host-to-terminal) data rate (must be O, 1,50, 75, 110, 134, 150, 300, 600, 1200, 
1800, 2000, 2400, 4800, 9600, 19200, or 38400). 
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NS 
NS11 


NS12 


NT 
NT11 


NT12 
NU 
NU11 
OB 
OBOO 
OB03 
OB11 


oc 

OcoOo 
OC03 
0C11 
0C21 


OD 

ODOO 
obDo1 
OE 

OEOO 
OE03 
OE11 
OE21 


OH 

OHOO 
OHO2 
OHO3 
OH11 


OH12 
OH21 


OH22 


ERROR CODES 


PROMPTSTRING=< Set-Prompt-String > =£c(N)(S)<int-array> 


(Levei 2): invaiid <int-array> parameter. (Must be an array holding from 0 to 10 <int> parameters. Each of 
the items in the array must be an <int> in the range from 0 to 1 27) 


(Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array>. 


EOLSTRING=< Set-Term-String> =®c(N)(T)<int-array> 


(Level 2): Invalid array count in <int-array>. (The array must hold from 0 to 2 < int> parameters. Each 
<int> in the array must be in the range from O to 127,) 


(Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array> parameter) 
BYPASSCANCEL=< Sei-Bypass-Cancel-Char> ="c(N}{U)<int> 

(Level 2): Invalid numeric equivalent of bypass-cancel character (must be in the range from 0 to 127). 
BLOCKMODE=< Arm-For-Block-Mode> =®c(O)(B)<int> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Levei 2): Tne communications queue size is smaller than the specified input block size. 

(Level 2): Invalid “arm-for-block-mode” parameter (must be 0 or 1). 


BCONTINUECHARS=< Set-Biock-Continue-Chars> =®c(O)(C)<int> <int> 
(Level 2): Unrecognized command. (Option 1 is not installed.) : 
(Level 2): Command is invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
(Level 2): Invalid first parameter (must be in the range from 0 to 127). 


(Level 2): Invalid second parameter (must be in the range from 0 to 127). 


DUPLEX=< Set-Duplex-Mode> =£c(O)(D)<int> 
(Level 2): Unrecognized command. (Option 1 is not installed.) 
(Level 2): Invalid duplex mode code (must be in range 0 to 3). 


BENDCHARS=-< Set-Block-End-Chars > ="c(O)(E)<int> <int> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
(Level 2): Invalid first parameter (must be in the range from 0 to 127). 

(Level 2): invalid second parameter (must be in the range from 0 to 127). 


BHEADERS=< Set-Block-Headers > =§c(O)(H) <int-array> <int-array> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Level 3): Out of memory while performing <set-block-headers> command. 

(Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 


(Level 2): Invalid character code (0 to 127) or array count (must be in range 0 to 10) in “transmit” (terminal- 
to-host) biock header. 


(Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array> ) 


(Level 2): invalid character code (O to 127) or array count (must be in range 0 to 10) in “receive” (host-to- 
terminal) block header. 


(Level 3): Parameter 2 memory error. (Out of memory while parsing the <int-array> ) 
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ERROR CODES 


OL  BLINELENGTH=< Set-Block-Line-Length> =£c(O)(L)< int> 

OLOO (Level 2): Unrecognized command. (Option 1 not installed, 

OLO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OL11 (Level 2): Invalid maximum number of characters in line (must be in the range from 5 to 65535). 


OM BMASTERCHARS=< Set-Block-Master-Chars> =€c(O)(M)<int> <int> 

OMOO (Level 2): Unrecognized command. (Option 1 is not installed) 

OMO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OM11 (Level 2): Invalid “transmit” (terminal-to-host) master char code (0 to 127). 

OM21 (Level 2): Invalid “receive” (host-to-terminal) master char code (0 to 127). 


ON BNONXMTCHARS=< Set-Block-Non-Xmt-Chars> = c(O)(N)< int-array> <int-array> 
ONOO (Level 2): Unrecognized command. (Option 1 is not installed.) 
ONO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 


ON11 (Level 2): Invalid character code or array count in list of terminal-to-host non-transmittable characters. (The 
array count must be in the range from 0 to 20, and the character codes must be in the range from 
0 to 127.) 


ON12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array> ) 


ON21 (Level 2): Invalid character code or array count in list of host-to-terminal non-transmittable characters. (The 
array count must be in the range from 0 to 20, and the character code must be in the range from 0 
to 127) 


ON22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the <int-array> ) 


OP BPACKING=< Set-Block-Packing> =*c(O)(P)<int> <int> <int> <int> 

OPOO (Level 2): Unrecognized command. (Option 1 is not installed.) 

OPO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OP11 (Level 2): Invalid terminal-to-host unpacked-bits-per-byte (must be 7 or 8). 

OP21 (Level 2): Invalid terminal-to-host packed-bits-per-pseudo-byte (must be 6, 7, or 8). 

OP31 (Level 2): Invalid host-to-terminal unpacked-bits-per-byte (must be 7 or 8). 

OP41 (Level 2): Invalid host-to-terminal packed-bits-per-pseudo-byte (must be 6, 7, or 8). 


OS BLENGTH=< Set-Block-Length> = c(O)(S)< int+> <int+> 

OSO00 (Level 2): Unrecognized command. (Option 1 is not installed.) 

OSO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OS11 (Level 2): Invalid terminal-to-host block length (must be in the range from 5 to 65535) 

OS21 (Level 2): Invalid host-to-terminal block length (must be in the range from 5 to 65535) 


OT BSTIMEOUT=< Set-Block-Timeout> =§c(O)(T)< int+> 
OTOO (Level 2): Unrecognized command. (Option 1 is not installed.) 
OT11 (Level 2): Invalid timeout (must be in the range from 0 to 65535 seconds). 
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ERROR CODES 


PA  PASSIGN=<Port-Assign>=®c(P)(A) <string> <string> <int>. 

PAOO (Levei 6): Unrecognized command. {Option 16 is not instalied} 

PA11 (Level 2): invalid port identifier (must be “PO:”,“P1:”, or “P2:”). 

PA12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 
PA13 (Level 2): Port in use. 


PA21 (Level 2): Invalid protocol identifier (must be “4642,” “4643,” “4662,” “4662/T,” “4663,” “4663/T,” or 
“PPORT”). 


PA22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the <string> ) 
PA31 (Level 2): Invalid device code (must be in the range from —32768 to + 32767). 


PB  PBITS=< Set-Port-Stop-Bits> =c(P)(B)< string> <int> <int> 

PBOO (Level 0): Unrecognized command. (Option 10 is not installed). 

PB11 (Level 2): Port identifier is invalid (must be “PO:”, “P1:”, or “P2:”). 

PR12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name < siring> ) 
PB1 3 (Level 2): Port in use. 

PB21 (Level 2): Invalid number of stop bits (must be 1 or 2). 

PB31 (Level 2): Invalid number of data bits (must be 5, 6, 7, or 8). 


PC PCOPY=<Port-Copy> = c(P)(C) <string> 

PCOO (Level 0): Unrecognized command. (Option 10 is not installed.) 

PCO2 (Level 3): 3PPI ISR transmit/receive error detected. 

PC11 (Level 2): Invalid “source” port (must be “HO:”, “PO:”, “P1:”, or “P2:”). 

PC12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the source specifier string) 
PC13 (Level 2): Port is busy. 

PC21 (Level 2): Invalid separator string (must be the empty string or “TO”). 

PC22 {Level 3): Parameter 2 memory error. (Out of memory while parsing the separator string.) 

PC23 (Level 2): Destination is busy. 


PC31 (Level 2): Invalid “destination” port (must be “HO:”, “PO:”, “P1:” or “P2:”, and must be different from the 
“source” port). 


PC32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the destination specifier.) 


PE PEOF=<Set-Port-EOF-String>=*c(P)(E)<string> <int-array> 

PEOO (Level 0): Unrecognized command. (Option 10 is not installed.) 

PE11 (Level 2): Port identifier is invalid (must be “PO:”, “P1:”, or “P2:”). 

PE12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 
PE13 (Level 2): Port in use. 


PE21 (Level 2): invalid EOF string. (The <int-array> must nave from 0 to 10 elements, and each <int> in the 
array must be in the range from 0 to 127.) 


PE22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the end-of-file string <int-array>. 
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PF 

PFOO 
PF11 
PF12 
PF13 
PF21 
PF31 
PF41 


Pl 
PIOO 
PIO2 


Pili 
Pi12 
Pli3 
Pl21 
PI31 
P1102 


PL 

PLOO 
PLi1 
PL12 
PL13 
PL20 


PL21 
PL22 


PM 

PMOO 
PM11 
PM12 
PM13 
PM21 
PM22 


A-16 


PFLAG=< Set-Port-Flagging-Mode> ="c(P)(F) < string> <int> <int> <int> 


(Level 0): 
(Level 2): 
(Level 3): 
(Level 2): 
(Level 2): 
(Level 2): 
(Level 2): 


Unrecognized command. (Option 10 is not installed) 

Port identifier is invalid (must be “PO:”, “P1:", or “P2:"). 

Parameter 1 memory error. (Out of memory while parsing the port name <string> .) 
Port in use. 

invalid Flagging mode (must be 0, 1 or 2). 

invalid “GO” character (must be in range 0 to 127). 


Invalid “STOP” character (must be in range O to 127: if non-zero, must be different from the “GO” 
character). 


MAPINDEX=< Map-Index-To-Pen> =®c (P)(I) <string> <int> <int> 


(Level 0): 
(Level 3): 


(Level 3): 
(Level 2): 
(Level 2): 
(Level 2): 
(Level 2): 
(Level 3): 


Unrecognized command (Option 10 is not installed). 


No memory is available for the index map. (To guarantee an available index map for a particular 
peripheral port, the peripheral port should have a plotter device assigned to it when the terminal is 
turned on) 


Port identifier is invalid (must be “PO:", “P1:", or “P2:”). 

Parameter 1 memory error. (Out of memory while parsing the port name string.) 
Port in use. 

invalid index (must be in the range from —2 to + 32767). 

Invalid pen number (must be in the range from —1 to 255). 

Not enough memory for index map. 


PLOT=< Plot> =€c(P)(L)< string> <string> 


(Level 0): 
(Level 2): 
(Level 3): 
(Level 2): 
(Level 2): 


(Level 2): 
(Level 3): 


Unrecognized command. (Option 10 is not installed.) 

Invalid first parameter (must be the empty string or “TO”). 

Parameter 1 memory error. (Out of memory while parsing the <string> parameter.) 
Device already in use. 


Non-existent destination device. (If destination specifier is of the form “FO:filename” or “F1: 
filename,” then the corresponding disk drive must be installed, and the file named must exist on a 
disk loaded in that disk drive). 


Invalid output specifier (must be “HO:", “PO:”, “P1:”, “P2:”, “FO:filename” or “F1:filename”). 
Parameter 2 memory error. (Out of memory while parsing the destination <string> ) 


PEOL=< Set-Port-EOL-String> =®c(P)(M)< string> <int-array> 


(Level 0): 
(Level 2): 
(Level 3): 
(Level 2): 
(Level 3): 
(Level 3): 


Unrecognized command. (Option 10 is not installed.) 

invalid port identifier (must be “PO:”, “P1:”, or “P2:”). 

Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 
Port in use. 

Invalid EOL string (must have 0, 1, or 2 characters). 

Parameter 2 memory error. (Out of memory while parsing the EOL-string <int-array> .) 
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PP 
PPOO 
PP11 
PP12 
PP13 
Pp21 


PQ 

PQoo 
PQO02 
PQ11 
PQ12 


PR 
PROO 
PR11 
PR12 
PR13 
PR21 


SA 

SA03 
SA10 
SA11 
SA21 


SA22 
SA31 
SA32 


sc 
SCO03 
$co2 


SD 

$D03 
SDi0 
S$D11 
$D21 


ERROR CODES 


PPARITY=< Set-Port-Parity> =&c(P)(P) <string> <int> 

(Level 0): Unrecognized command. (Option 10 is not installed). 

(Level 2): Port specifier is invalid (must be “PO:”, “P1:", or “P2:”). 

(Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string>) 
(Level 2): Port in use. 

(Level 2): Invalid parity code (must be in range 0 to 4). 


PORTSTATUS=< Report-Port-Status> =®c(P)(Q)< string> 

(Level 0): Unrecognized command. (Option 10 is not installed.) 

(Level 3): Memory error. (Out of memory while trying to retrieve status information.) 

(Level 2): Invalid port identifier (must be “PO:”, “P1:”, or “P2:”). 

(Level 3): Parameter 1 memory error. (Out of memory while parsing the port specifier string.) 


PBAUD=< Set-Port-Baud-Rate> =®c(P)(R)< string> <int> 

(Level 0): Unrecognized command. (Option 10 is not installed.) 

(Level 2): Port identifier is invalid (must be “PO:”, “P1:”, or “P2:”). 

(Level 3): Parameter 1 memory error. (Out of memory while parsing the port name string.) 

(Level 2): Port in use. 

(Level 2): Invalid baud rate (must be 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 
7200, or 9600). 

< Set-Segment-Class > = c(S)(A)< int> <int-array> <int-array> 

(Level 2): Command invalid at this time: the specified segment is currently being defined. 

(Level 2): Segment does not exist. 

(Level 2): Invalid segment number (must be in the range from —3 to —1, or from 1 to 32767). 


(Level 2): Invalid “removal” class number array. (Each class number must be —1 or in the range from 1 to 
64.) 


(Level 3): Parameter 2 memory error. (Out of memory while parsing the “removal” <int-array> parameter.) 
(Level 2): Invalid “include” class number array. (Same rules as for the “removal” class number array,) 
(Level 3): Parameter 3 memory error. (Out of memory while parsing the “addition” <int-array> parameter, 


< End-Segment> =£c(S) (C) 
(Level 2): invaiid at this time: no segment is currently being defined. 
(Level 3): Out of memory while performing <end-segment> command. 


< Set-Segment-Detectability > =c(S)(D)< int> <int> 

(Level 2): Command is invalid at this time. (The specified segment is currently being defined) 
(Level 2): Segment does not exist. 

(Level 2): Invalid segment number (must be in the range —3 to —1, or 1 to 32767). 

(Level 2): Invalid “detectability mode” (must be O or 1). 
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SG 

SG02 
SG10 
SG11 
$G21 
$G31 


SH 

SHO3 
SH10 
SH11 
SH21 


SI 

$103 
$102 
S110 
sii 
$121 
$!31 
$i41 


SK 
SK10 
SK11 


SL 

SL11 
SL12 
SL21 
SL22 


SM 


< Set-Graphtext-Font-Grid> =&c(S)(G)<int> <int> <int> 

(Level 3): Out of memory while defining font grid. 

(Level 2): Font already exists. 

{Level 2): Invalid font number (must be in the range from 0 to 32767). 
(Level 2): Invalid grid width (must be in the range from 1 to 4095). 
(Level 2): Invalid grid height (must be in the range from 1 to 4095). 


< Set-Segment-Highlighting> =c(S)(H)<int> <int> 

(Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 
(Level 2): Segment does not exist. 

(Level 2): Invalid segment number (must be in the range from —3 to —1, or from 1 to 32767). 
(Level 2): Invalid Highlighting mode (must be 0 or 1). 


< Set-Segment-image-Transform> =*c(S)(1)< int> <real> <real><real><xy> 

(Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 
(Level 3): Out of memory while transforming segment. 

(Level 2): Segment does not exist. 

(Level 2): Invalid segment number (must be in the range —3 to —1, or 1 to 32767). 

(Level 2): invalid X-scaling factor. (Must be in the range from —32767.0 to + 32767.0.) 
(Level 2): Invalid Y-scaling factor. (Must be in the range from —32767.0 to + 32767.0) 
(Level 2): Invalid rotation angle. (Must be in the range from —32767.0 to + 32767.0,) 


<Delete-Segment > = c(S)(K)<int> 
(Level 1): Segment does not exist. 
(Level 2): Invalid segment number (must be —3, —1, or in the range from 1 to 32767). 


< Set-Current-Matching-Class> =®c(S)(L)< int-array> <int-array> 

(Level 2): Invalid “include” segment-class array. (Class numbers must be in the range from 1 to 64.) 
(Level 3): Parameter 1 memory error. (Out of memory while parsing the “include” segment-class array.) 
(Level 2): Invalid “exclude” segment-class array. (Class numbers must be in the range from 1 to 64,) 
(Level 3): Parameter 2 memory error. (Out of memory while parsing the “exclude” segment-class array.) 


< Set-Segment-Writing-Mode> = c(S)(M)< int> <int> 


SMO3 (Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 


SM10 (Level 2): Segment does not exist. 


SM11 
SM21 


A-18 


(Level 2): Invalid segment number (must be in the range from —3 to —1, or from 1 to 32767). 
(Level 2): Invalid Writing mode (must be O or 1). 


REV, AUG 1981 4114 OPERATOR'S 


so 
3002 
$003 


S010 
$011 


SP 


ERROR CODES 


<Begin-Segment> = c(S)(0)< int> 


{Level 3): 
(Level 2): 


(Level 2): 


(Level 2): 


Out of memory while defining segment. 


Command is invalid at this time. (Another segment, a grephign character, or a panel is currently 


being defined.) 
Segment already exists. 
Invalid segment number (must be in the range from 1 to 32767). 


< Set-Pivot-Point > ="c(S)(P)< xy> 


No errors are detected for this command. 


sQ 

$Q10 
SQti 
$Q21 


$Q22 


SR 

SROS 
SR10 
SR11 
SR20 
SR21 


ss 

SS03 
$$10 
$S11 
$821 


ST 
STO02 
STO3 


ST11 
$T20 
ST21 


4114 OPERATOR'S 


<Report- Segment- -Status > =®c(S$)(Q)<int> <char- array 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 


Segment does not exist. 
Invalid segment number (must be in the range —3 to + 32767). 


Invalid array of codes. (Must include only the uppercase letters A, D, H, |, M, P, S, V, and X. Also, 


the array count must be in the range from 0 to 32767) 
Parameter 2 memory error. (Out of memory while parsing the aray-of-codes < char-array> ) 


<Rename-Segment>=c(S)(R)< int> <int> 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 2): 
(Level 2): 


Command is invalid at this time. (The specified segment is currently being defined.) 
Segment does not exist. 

Invalid segment number (must be in the range from 1 to 32767). 

A segment with that segment number already exists. 

Invalid segment number (must be in the range from 1 to 32767). 


< Set-Segment-Display-Priority> ="c(S)(S)< int> <int> 


(Level 2): 
(Level 2): 
(Level 2): 
(Level 2): 


Command is invalid at this time. (The specified segment is currently being defined.) 
Segment does not exist. 
invalid segment number (must be in the range from —3 io —i, or from 1 to 32767). 


Invalid priority number (must be in range —32768 to + eae 


<Begin-Graphtext-Character> ="c(S)(T)<int > <int> 


(Level 3): 
(Level 2): 


(Level 2): 
(Level 2): 
(Level 2): 


Out of memory whiie defining graphtext character. 


Command is invalid at this time. (A segment, panel, or graphtext character is currently being 
defined.) 


Invalid font number (must be in the range from 0 to 32767). 
That character already exists in this font. 
Invalid character number (must be in the range from 32 to 126). 
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ERROR CODES 


SU  <End-Graphtext-Character> = c(S)(U) 
SU03 (Level 1): This command is invalid at this time. (No graphtext character is being defined.) 


SV <Set-Segment-Visibility> = c(S)(V)<int> <int> . 
SVO3 (Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 
SV10 (Level 2): Segment does not exist. 

SV11 (Level 2): Invalid segment number (must be in the range from —3 to + 32767). 

S$V21 (Level 2): Invalid visibility mode (must be 0 or 1). 


SX  <Set-Segment-Position>=c(S)(X)<int><xy> 

SX03 (Level 2): Command is invalid at this time: the specified segment is currently being defined. 
SX10 (Level 2): Segment does not exist. 

SX11 (Level 2): Invalid segment number (must be in the range from —3 to + 32767) 


SZ  <Delete-Graphtext-Character>=®c(S)(Z)<int> <int> 

$Z03 (Level 2): Command is invalid at this time. (A graphtext character is currently being defined, 
$Z10 (Level 1): The specified font does not exist (no characters have been defined for that font). 
$Z11 (Level 2): Invalid font number (must be in the range from —1 to 32767). 

SZ20 (Level 1): The character specified does not exist in this font. 

$Z21 (Level 2): Invalid character number (must be —1, or in the range from 32 to 126). 


A-20 @ , AUG 1981 4114 OPERATOR'S 


Appendix B 


POWER UP SEQUENCE AND SELF TEST 


This appendix explains the messages which can a problem is detected. It also explains how to use the 
appear on the screen during the power up sequence if terminal’s extensive self test procedure. 


THE POWER UP SEQUENCE 


Each time you turn the terminal on, it automatically 
tests parts of its memory and circuitry. This is called 
the “power up sequence.” It takes from 15-60 seconds 
depending on what options your terminal has, and 
requires no operator interaction. 


During the power up sequence the lights in the 
keyboard go through the following sequence: 


All lights turn on. 

The CAPS LOCK light turns off. 

All other lights turn off. 

The XMT and RCV lights flash once simultaneously. 
All lights turn off. 


If the terminal bel! does not ring during the power up 
sequence (within 60 seconds of turning the terminal 
on), press the PAGE key. The screen is erased and the 
cursor flashes in the upper left corner of the screen. If 
the dialog area is enabled, the light in the DIALOG key 
is on and the cursor appears on the first available line 
of the dialog area. As soon as the cursor appears on 
the screen, the terminal is ready for use. 


If the power up sequence defects an error the terminal 
bell rings one, three, or four times, depending on the 
severity of the problem. There may also be a message 
on the screen. 


| 
POWER UP ERROR SELF TEST |§ MASTER RESET 


If the power up sequence encounters an error which 
will not prevent you from using the terminal (a non-fatal 


error, the bell rings one time and a:message.e Figure B-1. The MASTER RESET and SELF TEST buttons. 
displayed on the screen. 


If the terminal bell rings and you cannot read the 
message that is displayed, press the MASTER RESET 
button (Figure B-1). This causes the screen to be 
erased and the power up sequence to be run again so 
you can read the message. 
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An example of a such an error is when a problem exists 
which prevents you from using one of the terminal’s 
options. If this happens, the bell rings once and a 
message is displayed. For example, if the disk option 
failed the power up sequence, the following message 
would appear: 


ROM Set: 42-Fail 


If there is a problem with a tablet option, the following 
message appears: 


ROM Set: 13-Fail 


When an option fails, that option cannot be accessed 
but the rest of the terminal’s features can still be used. 
You can report the failure to a service person, or run 
the self test procedure (described later in this appen- 
dix) to isolate the failure more specifically. 


If an error occurs when the terminal is checking its 
keyboard, the following message can appear: 


Keyboard I-D — XX 


where XX is a keyboard ID value. If this occurs, record 
the message and contact a service person. 


The terminal has a “setup memory,” which remembers 
many of the terminal’s parameters or settings after it is 
turned off. These attributes are reinstated the next time 
the terminal is turned on. If that memory fails, the 
terminal bell rings once and the following message 
appears on the screen: 


Setup Defaults Reset 


This occurs if the terminal's configuration has been 
altered by putting in or taking out a circuit board. It also 
occurs if the battery which powers the setup memory 
fails. It is important to note that if you change one or 
more boards, only the parameters affected by the 
change are reset. If the setup memory battery fails, all 
parameters are reset to default. 
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FATAL ERRORS 


The terminal is not operational (fatal error) if its 
standard system fails. If that happens, the terminal bell 
rings four times, once when the following message 
appears on the Screen and three times when the fatal 
error is reported: 


ROM Set: 00-Fail 


If the power up sequence encounters a fatal error 
before the screen is checked, the terminal bell rings 
three times and the indicator and keyboard lights blink 
in a particular sequence. The sequence in which they 
flash indicates the test which has failed. 


If this occurs, you should record the light pattern and 
report it to a qualified service technician. You may also 
want to run the self test procedure, explained later in 
this section, which provides more detailed information 
that you can relay to a qualified service technician. 


When there is a fatal error, the terminal cannot be 
operated except to run the self test procedure. 
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SELF TEST 


GENERAL SELF TEST 


The power up sequence is an abbreviated test of the 
terminal’s memory and circuitry. 


A more extensive test of the terminal’s operating 
conditions is initiated by the SELF TEST button. The 
SELF TEST thoroughly tests the terminal and allows a 
service technician to make any necessary adjustments. 


If the terminal detects an error in the power up 
sequence, you can run the self test procedure to 
isolate the problem. You can then report the specific 
probiem to a technician. 


The self test is initiated by pressing the SELF TEST 
and RESET buttons (Figure B-1) in the foiiowing 
sequence: 


@ Press SELF TEST. 


@ Continue to hold SELF TEST while you press and 
release RESET. 


® Continue to hold SELF TEST until the indicator lights 
begin to ripple. 


@ Release SELF TEST. 


For about the first three minutes of the self test, the 
light patterns continue to change as tests are run. If a 
module fails, the terminal bell rings twice and a light 
pattern remains on for 20 seconds, indicating the test 
that has failed. You can record that pattern to report it 


s tarkaiaian 


to a tecnnician. 


Sub Messages 


In addition to this initial light-coded message, many 
messages have up to three “sub messages” which can 
provide a technician with even more information about 
the problem. 
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If you want to view the sub messages, start the 
following sequence within 20 seconds after the initial 
message appears. {If you take no action, the self test 
continues in 20 seconds.) 


1. Press the RETURN key. 


2. The terminal bell rings twice and another light 
pattern is displayed. 


3. Record the light pattern and press RETURN again. 


If there is another sub message, the bell rings 
twice and another light pattern is displayed. 


Record the light pattern and press RETURN. 


If there is a third sub message the bell rings twice 
and another light pattern is displayed. 


Record the light pattern and press RETURN. 


When you have seen all of the sub messages, there 
is no bell when you press RETURN, the light in the 
CAPS LOCK key turns off, and the indicator light 
pattern changes to indicate that the next test in the 
self test procedure is being run. 


Error messages are displayed in this manner as the 
terminal checks its display. After the display has been 
checked, subsequent error messages are displayed on 
the screen instead by light patterns. If the test halts 
during this part of the test, it is because the screen is 
filled with error messages. Make a hard copy or write 
down the error messages. Press the PAGE key and the 
test will continue. 


The self test procedure is explained in more detail in 
the 4114 Service Manual. 
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RESETTING SETUP MEMORY 


You may find it necessary or desirable to restore the 4, 


terminal's environment to the factory defaults. This is 
accomplished within the self test procedure. To do so, 
take the following steps: 


1. Initiate the self test as explained earlier in this 
appendix. 


2. Within 20 seconds of initiating the self test, press 
and hold the CTRL key while you press and 
release the C key, then release the CTRL key. This 
causes the light in the CAPS LOCK key to stop 
flashing and the following menu is displayed on the 
screen: 


411X Menu 
f1 4114 Display 


f2 Processor Board 
f3 Disk 


Selection 5. 
x 


3. Press function key 2 (F2). The following menu 
appears on the screen: 


Processor Board Menu 


f 1 CMOS-Reset 
f2 Keyboard 
f3 Host Port 


Selection 
* 
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Press function key 1 (F1). The following message 
appears below the menu: 


The term “CMOS RESET” means that the Setup 
memory has been restored to its factory default 
values. 


Processor Board Menu 


fi CMOS-Reset 
f2 Keyboard 
f3 Host Port 


Selection 


Selection 
x 


Press and hold the CTRL key while you press and 
release the E key, and then release the CTRL key. 
The terminal exits from the self test procedure, 
runs the power up sequence and when the cursor 
appears, it is ready for use. 
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Appendix C 


ESCAPE SEQUENCE COMMANDS 


Commands which are most commonly used by a 4114 
operator have an English-like format and are called 
setup commands, as explained in Section 6. 


However the terminal can also execute many more 
commands, which are issued in a format called “es- 
cape sequences.” They are called escape sequences 
because the first character in the command is always 
an escape. All terminal commands (including setup 
commands and command keys) have an escape se- 
quence format. 


Although escape sequences are primarily used by the 
host to send commands to the terminal, you can enter 
an escape sequence from the terminal as well, in either 
Setup or Local modes. The escape sequences are 
entered in a slightly different format for each of the two 


This appendix briefly discusses escape sequence 
commands and lists the format for each. See the 4114 
Host Programmer’s Manuai and the 4110 Series Com- 
mand Reference Manual for details on the use of 
escape sequences. 


TWO FORMATS 


There are two different formats for escape sequence 
commands. 


One format consists of the escape character followed 
by a single character op code. Escape sequences in 
this format can only be entered in Local mode ona 
4114. In a general form, this could be represented as 
follows (€p represents the escape character, X 
represents a single ASCII character): 


EcX 


For example, with a 4010-family terminal you can 
change the hardware text size by entering Local mode 
and pressing the escape key followed by a single 
character (either 8, 9, semi-colon, or colon). You can 
execute all 4010-style escape sequences of this 
format on a 4114. To specify the smallest hardware 
character size, you would enter Local mode and then 
enter the following escape sequence: 


Ec: 
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The second (4110-family) format consists of the 
escape character followed by a two-character op code 
and sometimes one or more parameters. Escape se- 
quences in this format can be entered in either Local or 
Seiup modes, though they are entered slightly differ- 
ently in each mode. This format could be represented 
as follows. (The &c represents the escape character. 
Each “(X)” represents a single ASCII character; the 
parentheses are included to distinguish between the 
characters. Each <parameter> may be an ASCII 
character, a string of ASCII characters, or a real 
number.) 


Ec(X)(X)< parameter> <parameter> ... 


For example, you can specify the hardware character 
size on a 4114 with an escape sequence as described 
in the previous paragraph. Or you can use an escape 
sequence which consists of the escape followed by the 
characters M, Z, and three integer parameters, which 
specify the scale of the character. The following 
escape sequence would specify a character size larger 
than the largest hardware character size and is in the 
format you would use in Local mode: 


®c(M)(Z)(3)(4) (9) 
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ESCAPE SEQUENCES IN SETUP MODE 


All escape sequence commands which consist of the 
escape character followed by a two-character op code 
can be executed in Setup mode. The following list 


details the format of escape sequences in Setup mode: 


@ The first character in the command is the “escape.” 
® All alphabetic characters must be upper case. 


@ There is no space between the “escape” character 
and the two-character op code of the command. 


@ \f the command has parameters, enter one or more 
spaces after the op code and then enter the 
parameters with one or more spaces between each 
parameter. 


@ Enter keyword parameters in their English-like for- 
mat; enter numeric values in a normal way (special 
encoding is not necessary as it is in Local mode). 


@ Terminate the command with a carriage return, 
which causes the command to be executed. 


For example, if the dialog area is enabled, but not 
visible you press the DIALOG key to make the dialog 
_ area visible. There is also an escape sequence 
command which makes the dialog area visible. 
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You can execute that command in Setup mode as 
follows: 


1. Put the terminal into Setup mode. If the light in the 
SET UP key is on, the terminal is already in Setup 
mode. if it is not on, press the SET UP key and the 
light turns on as the terminal enters Setup mode. 


2. The terminal should not be in Local mode. The light 
in the LOCAL key should be off; if it is on, press the 
key and the light will go off as the terminal exits 
from Local mode. 

3. The light in the CAPS LOCK key should be on, 
indicating that the key is active and ali 
characters will be upper case. 

4. Enter the following command: 


EcLV YES Sr 


That is, press the “ESC,” “L,” and “V” keys with no 
spaces between them. Then enter a “space” and the 
keyword “YES” followed by the carriage return. The 
characters are echoed on the screen as you enter them 
and the command is executed when you enter the 
carriage return. If the dialog area was not visible before 
you entered the command, it becomes visible. If the 
dialog area was already visible, nothing happens. 


The following command initializes the terminal for 
graphics input (GIN) mode, setting it to use the 
thumbwheels as the input device for ten points: 


EclE 0 10 Sr 


Press the SET UP key to exit from Setup mode. You 
can use the thumbwheels to locate the crosshair 
cursor and press ten alphabetic keys to exit from GIN 
mode. Or, you can put the terminal back into Setup 
mode and enter the following escape sequence com- 
mand: 


EID O Cr 
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ESCAPE SEQUENCES IN LOCAL MODE 


When the terminal is in Local mode, you can execute 
both 4010 and 4110-family escape codes. In both 
cases, escape sequences have the following charac- 
teristics. Notice that the first two characteristics are 
the same as using Setup mode, but the rest are 
different: 


® The first character in the command is the “escape.” 
@ All alphabetic characters must be upper case. 
e 


No carriage return is necessary; the command is 
executed as soon as you enter the last character. 


© Characters are not echoed on the screen as you 
type them. 


e@ Parameters of a command are not delimited by a 
space (although a space is a valid character in some 
commands). 


® Keywords and numeric values greater than nine are 
entered in an encoded form (see the 4110 Series 
Command Reference Manual). 
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The escape sequence to make the dialog area visible 
can be entered in Local mode as follows: 


1. Put the terminal into Local mode. If the light in the 
LOCAL key is on, the terminal is in Local mode. if it 
is not on, press the LOCAL key and the light turns 
on as the terminal enters Local mode. 


2. The terminal should not be in Setup mode. The 
light in the SET UP key should be off; if itis on, 
press the key and the light will go off as the 


termina! exits from Setup mode 


3. The light in the CAPS LOCK key should be on, 
indicating that the key is active and all alphabetic 
characters will be upper case. 


> 


Press the following keys; the characters will not be 
echoed on the screen. 


EoLV1 


The command is executed when you enter the last 
character in the command. If the dialog area was not 
visible before you entered the command, it becomes 
visible. If the dialog area was already visible, nothing 
happens. 


The following command initializes the terminal for 
graphics input (GIN) mode, setting it to use the 
thumbwheels as the input device for ten points (the 
colon at the end of the command is the coded form of 
the integer 10 in Local mode escape sequence com- 
mands): 


EcIEO: 


Press the LOCAL key to exit from Local mode. You can 
use the thumbwheels to locate the crosshair cursor 
and press ten alphabetic keys to exit from GIN mode. 
Or, you can put the terminal back into Local mode and 
enter the following escape sequence command: 


Ec IDO 
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LIST OF ESCAPE SEQUENCES 


The rest of this appendix lists the terminal's 4110-style 
escape sequences. They are listed alphabetically ac- 

cording to their two-character op code. The setup 
command is shown if the escape sequence has one. 


Escape Sequence 


Eo(1)(!)< ASCli-char> 
Ec(I)(A)<int> 
Ec(I)(C)<int> <int> 
Ec(IME)<int> <int+ > 
Ec(I)(F)<int> <int> <int> 


Ec(I)(G)< int> <int> <int> 
Eo(I)(H)< int> 

Eo(I)(I)<int> <int> 
Ec(I)(L)<int> 
Ec(I)(M)<int> 


Eo(I)(P)< int> 

Ec(I)(Q)< char> < char> 
Ec(I)(R)<int> <int> 

Ec(I)(S)< int> <char> <char> 
Ec(I}(T)<int> 


Ec(J)(C)< string> <string> <string> 
Ec(J)(D)< string> <string> <string> 
Ec(J)(E) 

Eo(J)(F)< string> <int> 

Eo(J)(K)< string> 


Ec(U)(L)< string> 
Ec(J)(P)< string> <int> 
Eo(U)(Q)< string> 
Ec(J)(R)< string> <string> <string> 
Ec(U)(S)< string> < string> <string> 
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Parameters for escape sequence commands are 
explained in the 4110 Series Command Reference 


Manual and the 4114 Host Programmer’s Manual. 


Disable-4953-Tablet-GIN 
Set-Pick-Aperture 
Set-GIN-Cursor 
Enable-GIN 
Set-GIN-Stroke-Filtering 


Set-GIN-Gridding 
Set-Tablet-Header-Characters 
Set-GIN-Inking 
Set-Report-Max-Line-Length 
Set-Report-EOM-Frequency 


Report-GIN-Point 
Report-Terminal-Settings 
Set-GIN-Rubberbanding 
Set-Report-Sig-Chars 
Set-Tablet-Status-Strap 


Copy 


Directory 
Stop-Spooling 


Format-Volume 


Delete-File 


Load 
Protect-File 


Report-Device-Status 


Rename-File 
Spool 
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Setup Command 


None 
PICKAPERTURE 
None 


TBFILTER 


GRIDDING 
TBHEADERCHARS 
None 

None 

REOM 


None 
None 
None 
None 
TBSTATUS 


COPY 
DIRECTORY 
STOP 
FORMAT 
DELETE 


LOAD 
PROTECT 
None 
RENAME 
SPOOL 
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Escape Sequence 


E¢(J)(V)< string> <int> <string> <string> 
Eo(K)(A)< int> 

Ec(K)(C) 

Eo(K)(D)<int> <int-array> 

Eo(K)(E)<int> 


Eo(K)(F)<int> 
Eo(K)(H)< int> 
Ee(K)(I)< int> 

Ec(K)(L)< int> 
Eo(K)(M)< int> 


Ec(K)(N)<int> 
Ec(K)(P)<int> 
Ec(K)(Q) 

Ee(K)(R)<int> 
Ec(K)(S)< int> 


Ec(K)(T)< int> 

Ec(K) (X)< int> 

Ec(K)(Y)< int> 

Eo(K)(Z)< int> <int> <int> 
Ee(L)(B)<int+ > 


Ee(L)(C)<int> 
Eo(L)(F)< xy> 
Ec(L)(G)< xy> 
Ee(L)(H)< xy> 
Eo(L)(K)< int> 


Ec(L)(L)< int> 
Ec(L)(M)< int> 
Ec(L)(T)< string> 
Eo(L)(¥)< int> 
Eo(L)(X)< xy> 
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Save 
Enable-Dialog-Area 
Cancel 
Define-Macro 

Echo 


| LFCR 
Hardcopy 
Ignore-Deletes 
Lock-Keyboard 
Set-Margins 


| Renew-View 
Set-Page-Full-Action 
Report-Errors 

CRLF 

Snoopy 


Set-Error-Threshold 
Expand-Macro 
Set-Execute-Toggle-Char 
Set-Edit-Chars 
Set-Dialog-Area-Buffer-Size 


Set-Dialog-Area-Chars 
Move 

Draw 

Draw-Marker 
Include-Copy-of-Segment 


Set-Dialog-Area-Lines 
Set-Dialog-Area-Writing-Mode 
Graphic-Text 
Set-Dialog-Area-Visibility 
Set-Dialog-Area-Position 


SAVE 
DAENABLE 
None 
DEFINE 
ECHO 


LFCR 

None 
IGNOREDEL 
LOCKKEYBOARD 
MARGINS 


RENEW 


| PAGEFULL 


None 
CRLF 
SNOOPY 


ERRORLEVEL 
None 
KEYEXCHAR 
EDITCHARS 
DABUFFER 


DACHARS 
None 
None 
None 
None 


DALINES 
DAMODE 
None 

DAVIS 
DAPOSITION 
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Escape Sequence 


Ec(L)(Z) 

Ec(M)(C)< int> <int> <int> 
Eco(M)(F)< int> 
Eo(M)(I)<int> 

Eo(M)(L)< int+ > 


Ec(M)(M)< int> 
Eo(M)(Q)< int> 
Eo(M)(R)< real> 
Ec(M)(T)< int+ > 
Ec(M)(V)< int> 


Ec(M) (W)<int> 

Ec(M)(Z)< int> <int> <int> 
Ec(N)(B)< int> 
Ec(N)(C)<int> <int> 
Eo(N)(D)<int> 


Ec(N)(E)< int-array> 
Ec (N)(F)<int> 
Eo(N)(K)< int+ > 
Ec(N)(L)<int+ > 
Ec(N)(M)< int> 


Eo(N)(P)< int> 

Ec(N)(Q)< int+ > 
Ec(N)(R)<int+ > <int+ > 
E¢(N)(S)< int-array> 
Ec(N)(T)<int-array> 


Ec(N)(U)<int> 
Ec(O)(B)<int> 
Eo(O)(C)< int> <int> 
E¢(O) (D) < int> 
Eo(O)(E)< int> <int> 


Clear-Dialog-Scroll 
Set-Graphtext-Size 
Set-Graphtext-Font 
Set-Pick-ID 
Set-Line-Index 


Set-Marker-Type 
Set-Graphtext-Precision 


Set-Graphtext-Rotation 
Set-Text-Index 
Set-Line-Style 


Set-Line-Width 
Set-Alphatext-Size 
Set-Stop-Bits 
Set-EOM-Chars 
Set-Transmit-Delay 


Set-EOF-String 
Set-Flagging-Mode 
Set-Break-Time 
Set-Transmit-Rate-Limit 
Prompt-Mode 


Set-Parity 
Set-Queue-Size 
Set-Baud-Rates 
Set-Prompt-String 
Set-EOL-String 


Set-Bypass-Cancel-Char 
Arm-For-Block-Mode 
Set-Block-Continue-Chars 
Set-Duplex-Mode 
Set-Block-End-Chars 
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Setup Command 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
ALPHASIZE 
STOPBITS 
EOMCHARS 
XMTDELAY 


EOFSTRING 
FLAGGING 
BREAKTIME 
XMTLIMIT 
PROMPTMODE 


PARITY 
QUEUESIZE 
BAUDRATE 
PROMPTSTRING 
EOLSTRING 


BYPASSCANCEL 
BLOCKMODE 
BCONTINUECHARS 
DUPLEX 
BENDCHARS 
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Escape Sequence 


Ec(O)(H)< int-array> < int-array> 
Eo(O)(L)< int> 

Ec¢(O)(M)< int> <int> 

Ec(O) (N)< int-array> <int-array> 
Eg(O)(P)< int> <int> <int> <int> 


Eo(O)(S)<intt+ > <int+ > 
E¢(O)(T)<int+ > 

Ec(P)(A)< string> <string> <int> 
E¢(P)(B)< string> <int> <int> 
Ec(P)(C)< string> 


E¢(P)(E)< string> <int-array> 

Ec (P)(F) <string> <int> <int> <int> 
Ec(P)(I)<string> <int> <int> 
E¢(P)(L)<string> <string> 
Ec(P)(M)< string> <int-array> 
Ec(P)(P)< string> < int> 


Ec(P)(Q)< string> 

Ec(P)(R) <string> <int> 

Ec(S)(A)< int> <int-array> < int-array> 
Ee(S)(C) 

Eo(S)(D)<int> < int> 


E¢(S)(G)<int> < int> <int> 

Ec(S)(H)< int> < int> 

E,(S)(I)<int> <real> < real> < real><xy> 
Ec(S)(K)<int> 

Eo(S)(L)<int-array> < int-array> < int-array> 
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Set-Block-Headers 
Set-Block-Line-Length 
Set-Block-Master-Chars 


‘Set-Block-Non-Xmt-Chars 


Set-Block-Packing 


Set-Block-Length 
Set-Block-Timeout 
Port-Assign 
Set-Port-Stop-Bits 
Port-Copy 


Set-Port-EOF-String 
Set-Port-Flagging-Mode 
Map-index-To-Pen 

Plot 
Set-Port-EOL-String 
Set-Port-Parity 


Report-Port-Status 
Set-Port-Baud-Rate 
Set-Segment~ Crass 
End-Segment 
Seg-Segment-Detectability 


Set-Graphtext-Font-Grid 
Set-Segment-Highlighting 


Set-Segment-Image-Transform 


Delete-Segment 
Set-Current-Matching-Class 
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BHEADERS 


Setup Command 


BLINELENGTH 
BMASTERCHARS 
BNONXMTCHARS 
BPACKING 


BLENGTH 
BTIMEOUT 
PASSIGN 
PBITS 
PCOPY 


PEOF 
PFLAG 
MAPINDEX 
PLOT 
PEOL 
PPARITY 


PORTSTATUS 
PBAUD 

None 

None 

None 


None 
None 
None 
None 
None 
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Escape Sequence 


Eo(S)(M)<int> <int> 
Eo(S)(O)< int> 
Eo(S)(P)< xy> 
Ec(S)(Q)< int> < char-array> 
Ec(S)(R)< int> <int> 


Ec(S)(S)<int> <int> 
Ec(S)(T)<int> <int> 
Ec(S)(U) 

Eo(S)(V)< int> < int> 
Eo(S)(X)< int> < xy> 
Eo(S)(Z)<int> <int> 
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Set-Segment-Writing Mode 
Begin-Segment 

Set-Pivot-Point 
Report-Segment-Status 


Rename-Segment 


Set-Segment-Display-Priority 


Begin-Graphtext-Character 


| End-Graphtext-Character | 


Set-Segment-Visibility 


Set-Segment-Position 


Delete-Graphtext-Character 


am 


Setup Command 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 
None 
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Appendix D 


ASCII CHARTS 


This appendix includes a standard ASCII code chart The code charts are: 
and additional ASCII code charts which define the Table Description 
ific ch ters d as parameters (indicated b 
specific characters used as p ( y D-1 ASCII Code Chart 


unshaded areas). D-2 Characters Used in <Char> Parameters 
D-3 Characters Used in <Int> and <Int+ > 


Parameters 
D-4 Characters Used in < Int-Report> 
Parameters 
D-5§ Characters Used in <Xy> Parameters 
D-6 Characters Used in < Xy-Report> 
Parameters 
Table B-4 


ASCII (ISO-7-US) CODE CHART 


BITS 
B4 B3 B2 BL 


pond 


UPPERCASE | LOWERCASE 


| 


3] 19) 
EOT § DC4 


in| 


[on some keyboards of systems 
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ASCII CODE CHARTS 


Table D-2 


CHARACTERS USED IN < CHAR> PARAMETERS 


; i :-) a) - 
Se nd ee eo] N 
Bed I od od OE od ~ 
i te aa LEE 
rh UMN COS 
oF OF OF & 
~~ ~h  OS ULLUOUm 
eee 
ind Ww 
& o| TC ~ ® 
Noe fe a = sb eas ce 
N 


oS Rg _ 
N N 


65 
6 
6 
69 


be as es (es hea ee, eae ae ]2 = 


= 
te) 
“ha 


Eke 


on some keyboards or systems 


* 
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D-2 


<Hil> Characters 


1 on some keyboards or systems 
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Table D-3 


CHARACTERS USED IN <INT> AND <INT+> PARAMETERS 


ASCil CODE CHARTS 


<Lol> Characters 


D-3 


ASCII CODE CHARTS 


Table D-4 


CHARACTERS USED IN <INT-REPORT> PARAMETERS 


<Hil-Report> Characters <Lol-Report> Characters 


= <} Cl a] wo) Dol vw 


Np <<) 


1 on some keybonris or syaiems 
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ASCII CODE CHARTS 


Table D-5 


CHARACTERS USED IN < XY> PARAMETERS 


<HiY>,<HiX> Characters 


<LoX> Characters 
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5) 
e 
a 


ASCII CODE CHARTS 


Table D-6 


CHARACTERS USED IN < XY-REPORT> PARAMETERS 


| on some keyboards or systems 
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Appendix E 


OPTIONAL KEYBOARDS 


The following optional keyboards are available for the optional keyboards, see the 4112 or 4114 Service 
terminal. For information on how to install these Manuals. 


OPTION 4A: UNITED KINGDOM CHARACTER SET 


This option permits the terminal to change to a United key is pressed (or the appropriate code received by the 
Kingdom keyboard layout so that the United Kingdom terminal), the “£” sign is displayed on the screen. The 
characters are displayed. The only change is that the revised keyboard configuration is shown in Figure E-1 


“#" sign is replaced by the English “£” sign. When this and the revised ASC!I code chart is shown in table E-1. 


CANCEL 


PAGE 
FULL XMT 


J 


DIALOG SETUP LOCAL HARD 
AREA COPY 


Figure E-1. United Kingdom Keyboard. 
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Table E-1 
UNITED KINGDOM CHARACTER SET 


3673-51 
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OPTIONAL KEYBOARDS 


OPTION 4C: SWEDISH CHARACTER SET 


This option changes the standard keyboard configura- pressed (or the appropriate codes are received by the 


tion to a Swedish layout and allows Swedish charac- 
ters to be dispiayed. There are 17 changes to the 
keyboard, with three of these changes being new 


terminal), the corresponding characters are displayed 
on the screen. The revised keyboard configuration is 
shown in Figure E-2 and the revised ASCII code chart 


alphabet characters. When these seventeen keys are is shown in Table E-2. 


& 


CLEAR CANCEL 


KYBD PAGE 
LOCK FULL XMT RCV 


o oo 6 & 


DIALOG SETUP LOCAL HARD 
AREA COPY 


Figure E-2. Swedish Keyboard. 
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Table E-2 
SWEDISH CHARACTER SET 


3673-52 
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OPTIONAL KEYBOARDS 


OPTION 4E: ASCII/APL CHARACTER SET 


This option enables selection of either ASCII or APL That is, the same as a standard keyboard. To obtain the 
characters to be entered and displayed. There are 47 APL (A Programming Language) character set, the ESC 
different keys in this character set, with some of the and CTRL N keys must be pressed. Once this is done, 
symbols printed on the front of the keys as well as the the terminal operates in APL mode. The APL codes are 
tops of the keys (see Figure E-3). Tables E-3 and E-4 generated when a key is pressed and APL characters 
show the ASCII and APL coding. are displayed on the screen as a result of pressing 


keys or receiving data from the host computer. 


When the terminal is turned on (and during normal 
operation), the keyboard will operate in ASCII mode. To exit APL mode (back to ASCII), the ESC and CTRL O 
keys must be pressed. 


= ZN sh 
3 


chen tect Ay PA (AARAR AE 
MAA aealy | “ak ayes) 
Geuecer Ni cay (Ea) eeeh 
(yay AY cheney \ Vey 


am 


Figure E-3. APL Keyboard Option. 
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Table E-3 
ASCII CODE CHART 


BITS 
B4 B3 B2 Bl 


HIGH X & Y 


@ | Pp 
fs 16! 32 4g! a4! go! 96 4 
| | | 
ah DEL "33 : 49| A a Cal Ba 
/a/1o) STX | DC2' ” | 2 | Be) Ro) o., r 
BEX: C3 eee og ee il ig 
| 3 19 35 51 67 83 99 
o/EOT DCA $ |) 46D] Ti dit 
i : 4 20 36 52 68 84 100 
ENO; NAK) % 5 | E | Ul e | u 
5 21 37 53 69 85 101 
ACK; SYN! & | 6 | Fl vi¢dov 
| 6 22 38 54 70 86 102 118 
BEL/ETB. ’ | 7/G/Wi|gilw 
i BELL 7 23 39 55 71 87 103 119 
1/0 0/0),BS | CAN | ( 8 | H | X h | x 
SPACE 8 24 40 56 72 88 104 120 
t}oiaj1] HT | EM |) 9 | y y 
9 25 41 57 73 89 105 121 
1ioi1}o] LF | SUB] x : J Z l Z 
10 26 42 58 74 90 106 122 
PETES] + gl KE Od Kod hoe 
FES 
M 


lt 
le) 
—, 
N 
™N 
a 
© 
w 
a) 
oS 
[fe] 
Ww 
a 
Ro 
an 


_ mare —_ 
—_ —_ Qo 
za S 


LR es 


114 > N /\ nojm 
14 30 46 62 78 94 110 126 
RUBOUT 
15 31 47 63 79 95 111 127 


3873-53 
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Table E-4 
APL CODE CHART 
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OPTIONAL KEYBOARDS 


17 


3673-54 
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OPTIONAL KEYBOARDS 


OPTION 4F: DANISH/NORWEGIAN KEYBOARD 


This option changes to a Danish/Norwegian standard pressed (or the appropriate codes are received by the 
keyboard layout so that the Danish/Norwegian charac- terminal), the corresponding characters are displayed 
ters are displayed. There are 17 changes to the on the screen. The revised keyboard configuration is 
keyboard, with three of the changes being new shown in Figure E-4 and the revised ASCII code chart 
alphabetic characters. When these seventeen keys are is shown in Table E-5. 


CANCEL 


KYBD PAGE 
LOCK = FULL 
o 


Figure E-4. Danish/Norwegian Keyboard. 
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Table E-5 
DANISH/NORWEGIAN CHARACTER SET 


i, 


ajojo 0 NUL] DLE = a 7 ©. Ps ne 
gio) al STK. DO. a re Bi] Ri bir 
Re ; 34 66 82 98; 114 
p20) EE x C8 | # 7 cae oe ae, ee ae 
| | -* 51 67: g3| ce 
EOT bos a | D ; T d 
rete ys 5 Ei Uj)e|u 


11010 10| “BS TAN 


did aimee le 


Laie 
Pep al = 


itt ie SO RS n 
110; 126 
titer trot 
i} 127 


3673-55 
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